diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 00000000..3014c3f0 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,80 @@ +# Simple workflow for deploying static content to GitHub Pages +name: Deploy static content to Pages + +on: + # Runs on pushes targeting the default branch + push: + branches: ["main"] + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow one concurrent deployment +concurrency: + group: "pages" + cancel-in-progress: true + +jobs: + # Single deploy job since we're just deploying + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + steps: + # - name: Harden Runner + # uses: step-security/harden-runner@main + # with: + # egress-policy: audit # TODO: change to 'egress-policy: block' after couple of runs + - name: Checkout + uses: actions/checkout@main + - name: 🐍 Set up Python + uses: actions/setup-python@main + with: + python-version: "3.12" + cache: "pip" + cache-dependency-path: "pyproject.toml" + - name: Install system dependencies + run: | + sudo apt update && sudo apt install -y \ + pkg-config libcairo-dev libpango1.0-dev wget fonts-roboto + wget -qO- "https://yihui.org/tinytex/install-bin-unix.sh" | sh + echo ${HOME}/.TinyTeX/bin/x86_64-linux >> $GITHUB_PATH + - name: Install LaTeX and Python dependencies + run: | + tlmgr update --self + tlmgr install \ + babel-english ctex doublestroke dvisvgm frcursive fundus-calligra jknapltx \ + mathastext microtype physics preview ragged2e relsize rsfs setspace standalone \ + wasy wasysym + + - name: 🔧 Build HTML + run: | + sudo apt-get install graphviz + sudo apt-get update && sudo apt-get upgrade + sudo apt install build-essential python3-dev libcairo2-dev libpango1.0-dev ffmpeg + pip install --upgrade pip + conda install -c conda-forge box2d-py + pip install taolib + pip install -e .[linkify,rtd] --upgrade + conda install -c conda-forge pandoc compilers cppyy + conda install -c conda-forge ffmpeg manim + pip install manim + invoke doc + - name: Setup Pages + uses: actions/configure-pages@main + - name: Upload artifact + uses: actions/upload-pages-artifact@main + with: + # Upload entire repository + path: 'docs/build/html/' + - name: 🚀 Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@main + # uses: peaceiris/actions-gh-pages@v3.6.1 diff --git a/docs/conf.py b/docs/conf.py index fb3843b9..79dbe08a 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -18,7 +18,9 @@ version = __version__ master_doc = "index" -language = "en" +language = "zh_CN" +locale_dirs = ['../locales/'] # po files will be created in this directory +gettext_compact = False # optional: avoid file concatenation in sub directories. # -- General configuration --------------------------------------------------- diff --git a/locales/zh_CN/LC_MESSAGES/apidocs.po b/locales/zh_CN/LC_MESSAGES/apidocs.po new file mode 100644 index 00000000..d27682cc --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/apidocs.po @@ -0,0 +1,2911 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/apidocs/index.rst:2 +msgid "API Reference" +msgstr "" + +#: ../../../docs/apidocs/index.rst:4 +msgid "This page contains auto-generated API reference documentation [#f1]_." +msgstr "" + +#: ../../../docs/apidocs/index.rst:11 +msgid "" +"Created with `sphinx-autodoc2 `_" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:2 +msgid ":py:mod:`myst_parser`" +msgstr "" + +#: ../../../myst_parser/__init__.py:1 +msgid "" +"An extended [CommonMark](https://spec.commonmark.org/) compliant parser, " +"with bridges to [docutils](https://docutils.sourceforge.io/) and " +"[Sphinx](https://github.com/sphinx-doc/sphinx)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:11 +msgid "Subpackages" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:23 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.rst:10 +msgid "Submodules" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:37 +msgid "Package Contents" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser._compat.rst:15 +#: ../../../docs/apidocs/myst_parser/myst_parser.cli.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:23 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:27 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:33 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:24 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:27 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:31 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.mdit.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:39 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:65 +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:40 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:27 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:24 +msgid "Functions" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:46 +msgid ":py:obj:`setup `" +msgstr "" + +#: ../../../myst_parser/__init__.py:1 +msgid "Initialize the [Sphinx](https://github.com/sphinx-doc/sphinx) extension." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser._compat.rst:26 +#: ../../../docs/apidocs/myst_parser/myst_parser.cli.rst:24 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:58 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:59 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:68 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:67 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:47 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:35 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:33 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:36 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:41 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:92 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.mdit.rst:24 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:50 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:76 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:35 +#: ../../../docs/apidocs/myst_parser/myst_parser.rst:52 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:41 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:27 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:41 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:35 +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:35 +msgid "API" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser._compat.rst:4 +msgid ":py:mod:`myst_parser._compat`" +msgstr "" + +#: ../../../myst_parser/_compat.py:2 +msgid "Helpers for cross compatibility across dependency versions." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser._compat.rst:12 +#: ../../../docs/apidocs/myst_parser/myst_parser.cli.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.mdit.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:10 +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:10 +msgid "Module Contents" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser._compat.rst:21 +msgid ":py:obj:`findall `" +msgstr "" + +#: ../../../myst_parser/_compat.py:10 +msgid "Iterate through" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.cli.rst:2 +msgid ":py:mod:`myst_parser.cli`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.cli.rst:19 +msgid ":py:obj:`print_anchors `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.rst:2 +msgid ":py:mod:`myst_parser.config`" +msgstr "" + +#: ../../../myst_parser/config/__init__.py:2 +msgid "" +"This module holds the global configuration for the parser " +"``MdParserConfig``." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:2 +msgid ":py:mod:`myst_parser.config.dc_validators`" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:2 +msgid "" +"Validators for dataclasses, mirroring those of https://github.com/python-" +"attrs/attrs." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:13 +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:13 +msgid "Classes" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:19 +msgid ":py:obj:`ValidatorType `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:29 +msgid ":py:obj:`validate_field `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:12 +msgid "" +"Validate the field of a dataclass, according to a `validator` function " +"set in the field.metadata." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:32 +msgid "" +":py:obj:`validate_fields " +"`" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:28 +msgid "" +"Validate the fields of a dataclass, according to `validator` functions " +"set in the field metadata." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:35 +msgid ":py:obj:`any_ `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:47 +msgid "A validator that does not perform any validation." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:38 +msgid ":py:obj:`instance_of `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:53 +msgid "" +"A validator that raises a `TypeError` if the initializer is called with a" +" wrong type for this particular attribute (checks are performed using " +"`isinstance` therefore it's also valid to pass a tuple of types)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:41 +msgid ":py:obj:`optional `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:75 +msgid "" +"A validator that makes an attribute optional. An optional attribute is " +"one which can be set to ``None`` in addition to satisfying the " +"requirements of the sub-validator." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:44 +msgid ":py:obj:`is_callable `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:91 +msgid "" +"A validator that raises a `TypeError` if the initializer is called with a" +" value for this particular attribute that is not callable." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:47 +msgid ":py:obj:`in_ `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:104 +msgid "" +"A validator that raises a `ValueError` if the initializer is called with " +"a value that does not belong in the options provided. The check is " +"performed using ``value in options``." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:50 +msgid ":py:obj:`deep_iterable `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:127 +msgid "A validator that performs deep validation of an iterable." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:53 +msgid ":py:obj:`deep_mapping `" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:147 +msgid "A validator that performs deep validation of a dictionary." +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:15 +#: ../../../myst_parser/config/dc_validators.py:33 +msgid "" +"The validator function should take as input (inst, field, value) and " +"raise an exception if the value is invalid." +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:31 +msgid "This function should be called in the `__post_init__` of the dataclass." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst:73 +msgid "Bases: :py:obj:`typing.Protocol`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.dc_validators.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst +msgid "Parameters" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:57 +msgid "The type to check for." +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:108 +msgid "Allowed options." +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:129 +msgid "Validator to apply to iterable members" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:130 +msgid "Validator to apply to iterable itself" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:149 +msgid "Validator to apply to dictionary keys" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:150 +msgid "Validator to apply to dictionary values" +msgstr "" + +#: ../../../myst_parser/config/dc_validators.py:151 +msgid "Validator to apply to top-level mapping attribute (optional)" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:2 +msgid ":py:mod:`myst_parser.config.main`" +msgstr "" + +#: ../../../myst_parser/config/main.py:2 +msgid "The configuration for the myst parser." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:19 +msgid ":py:obj:`UrlSchemeType `" +msgstr "" + +#: ../../../myst_parser/config/main.py:56 +msgid "Type of the external schemes dictionary." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:22 +msgid ":py:obj:`MdParserConfig `" +msgstr "" + +#: ../../../myst_parser/config/main.py:174 +msgid "Configuration options for the Markdown Parser." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:33 +msgid ":py:obj:`check_extensions `" +msgstr "" + +#: ../../../myst_parser/config/main.py:27 +msgid "Check that the extensions are a list of known strings" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:36 +msgid ":py:obj:`check_url_schemes `" +msgstr "" + +#: ../../../myst_parser/config/main.py:64 +msgid "Check that the external schemes are of the right format." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:39 +msgid "" +":py:obj:`check_sub_delimiters " +"`" +msgstr "" + +#: ../../../myst_parser/config/main.py:110 +msgid "" +"Check that the sub_delimiters are a tuple of length 2 of strings of " +"length 1" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:42 +msgid ":py:obj:`check_inventories `" +msgstr "" + +#: ../../../myst_parser/config/main.py:121 +msgid "Check that the inventories are a dict of {str: (str, Optional[str])}" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:45 +msgid "" +":py:obj:`check_heading_slug_func " +"`" +msgstr "" + +#: ../../../myst_parser/config/main.py:138 +msgid "Check that the heading_slug_func is a callable." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:48 +msgid "" +":py:obj:`check_fence_as_directive " +"`" +msgstr "" + +#: ../../../myst_parser/config/main.py:165 +msgid "Check that the extensions are a sequence of known strings" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:51 +msgid ":py:obj:`merge_file_level `" +msgstr "" + +#: ../../../myst_parser/config/main.py:503 +msgid "Merge the file-level topmatter with the global config." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:54 +msgid ":py:obj:`read_topmatter `" +msgstr "" + +#: ../../../myst_parser/config/main.py:568 +msgid "Read the (optional) YAML topmatter from a source string." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:69 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:73 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:98 +msgid "Bases: :py:obj:`typing.TypedDict`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:74 +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:372 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:78 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:103 +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:155 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:105 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:51 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:43 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:65 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:87 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:109 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:46 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:55 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:74 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:129 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:148 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:169 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:128 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:84 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:86 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:103 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:160 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:176 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:190 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:204 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:228 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:242 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:256 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:270 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:284 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:298 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:310 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:356 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:73 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:51 +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:45 +msgid "Initialization" +msgstr "" + +#: ../../../myst_parser/config/main.py:2 ../../../myst_parser/inventory.py:2 +#: ../../../myst_parser/mocking.py:2 +#: ../../../myst_parser/parsers/parse_html.py:2 +msgid "Initialize self. See help(type(self)) for accurate signature." +msgstr "" + +#: ../../../myst_parser/config/main.py:176 +msgid "" +"Note in the sphinx configuration these option names are prepended with " +"``myst_``" +msgstr "" + +#: ../../../myst_parser/config/main.py:480 +msgid "Return a new object replacing specified fields with new values." +msgstr "" + +#: ../../../myst_parser/config/main.py:482 +msgid "Note: initiating the copy will also validate the new fields." +msgstr "" + +#: ../../../myst_parser/config/main.py:488 +msgid "Return all attribute fields in this class." +msgstr "" + +#: ../../../myst_parser/config/main.py:492 +msgid "Return a dictionary of field name -> value." +msgstr "" + +#: ../../../myst_parser/config/main.py:496 +msgid "Yield triples of (name, value, field)." +msgstr "" + +#: ../../../myst_parser/config/main.py:505 +msgid "Global config." +msgstr "" + +#: ../../../myst_parser/config/main.py:506 +msgid "Topmatter from the file." +msgstr "" + +#: ../../../myst_parser/config/main.py:507 +msgid "Function to call with a warning (type, message)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst +msgid "Returns" +msgstr "" + +#: ../../../myst_parser/config/main.py:508 +msgid "A new config object" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.config.main.rst:367 +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:41 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:218 +msgid "Bases: :py:obj:`Exception`" +msgstr "" + +#: ../../../myst_parser/config/main.py:564 +msgid "Topmatter parsing error." +msgstr "" + +#: ../../../myst_parser/config/main.py:570 +msgid "" +"This is identified by the first line starting with `---`, then read up to" +" a terminating line of `---`, or `...`." +msgstr "" + +#: ../../../myst_parser/config/main.py:573 +msgid "The source string to read from" +msgstr "" + +#: ../../../myst_parser/config/main.py:574 +msgid "The topmatter" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.docutils_.rst:2 +msgid ":py:mod:`myst_parser.docutils_`" +msgstr "" + +#: ../../../myst_parser/docutils_.py:2 +msgid "" +"A module for compatibility with the docutils>=0.17 `include` directive, " +"in RST documents:" +msgstr "" + +#: ../../../myst_parser/docutils_.py:4 ../../../myst_parser/sphinx_.py:4 +msgid "For example::" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:2 +msgid ":py:mod:`myst_parser.inventory`" +msgstr "" + +#: ../../../myst_parser/inventory.py:2 +msgid "Logic for dealing with sphinx style inventories (e.g. `objects.inv`)." +msgstr "" + +#: ../../../myst_parser/inventory.py:4 +msgid "" +"These contain mappings of reference names to ids, scoped by domain and " +"object type." +msgstr "" + +#: ../../../myst_parser/inventory.py:6 +msgid "" +"This is adapted from the Sphinx inventory.py module. We replicate it " +"here, so that it can be used without Sphinx." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:19 +msgid ":py:obj:`InventoryItemType `" +msgstr "" + +#: ../../../myst_parser/inventory.py:31 +msgid "A single inventory item." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:22 +msgid ":py:obj:`InventoryType `" +msgstr "" + +#: ../../../myst_parser/inventory.py:40 +msgid "Inventory data." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:25 +msgid ":py:obj:`InventoryFileReader `" +msgstr "" + +#: ../../../myst_parser/inventory.py:181 +msgid "A file reader for an inventory file." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:28 +msgid ":py:obj:`InvMatch `" +msgstr "" + +#: ../../../myst_parser/inventory.py:278 +msgid "A match from an inventory." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:39 +msgid ":py:obj:`from_sphinx `" +msgstr "" + +#: ../../../myst_parser/inventory.py:53 +msgid "Convert from a Sphinx compliant format." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:42 +msgid ":py:obj:`to_sphinx `" +msgstr "" + +#: ../../../myst_parser/inventory.py:79 +msgid "Convert to a Sphinx compliant format." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:45 +msgid ":py:obj:`load `" +msgstr "" + +#: ../../../myst_parser/inventory.py:94 +msgid "Load inventory data from a stream." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:48 +msgid ":py:obj:`match_with_wildcard `" +msgstr "" + +#: ../../../myst_parser/inventory.py:265 +msgid "" +"Match a whole name with a pattern, that can include `*` wildcards, to " +"match 0 or more characters." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:51 +msgid ":py:obj:`filter_inventories `" +msgstr "" + +#: ../../../myst_parser/inventory.py:295 +msgid "Filter a set of inventories." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:54 +msgid "" +":py:obj:`filter_sphinx_inventories " +"`" +msgstr "" + +#: ../../../myst_parser/inventory.py:338 +msgid "Filter a set of sphinx style inventories." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:57 +msgid ":py:obj:`filter_string `" +msgstr "" + +#: ../../../myst_parser/inventory.py:387 +msgid "Create a string representation of the filter, from the given arguments." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:60 +msgid ":py:obj:`fetch_inventory `" +msgstr "" + +#: ../../../myst_parser/inventory.py:407 +msgid "Fetch an inventory from a URL or local path." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.inventory.rst:63 +msgid ":py:obj:`inventory_cli `" +msgstr "" + +#: ../../../myst_parser/inventory.py:418 +msgid "Command line interface for fetching and parsing an inventory." +msgstr "" + +#: ../../../myst_parser/inventory.py:34 +msgid "The location of the item (relative if base_url not None)." +msgstr "" + +#: ../../../myst_parser/inventory.py:36 +msgid "Implicit text to show for the item." +msgstr "" + +#: ../../../myst_parser/inventory.py:43 +msgid "The name of the project." +msgstr "" + +#: ../../../myst_parser/inventory.py:45 +msgid "The version of the project." +msgstr "" + +#: ../../../myst_parser/inventory.py:47 +msgid "The base URL of the `loc`." +msgstr "" + +#: ../../../myst_parser/inventory.py:49 +msgid "Mapping of domain -> object type -> name -> item." +msgstr "" + +#: ../../../myst_parser/inventory.py:183 +msgid "This reader supports mixture of texts and compressed texts." +msgstr "" + +#: ../../../myst_parser/inventory.py:268 ../../../myst_parser/inventory.py:298 +#: ../../../myst_parser/inventory.py:341 +msgid "To include a literal `*` in the pattern, use `\\*`." +msgstr "" + +#: ../../../myst_parser/inventory.py:297 ../../../myst_parser/inventory.py:340 +msgid "" +"Filters are strings that can include `*` wildcards, to match 0 or more " +"characters." +msgstr "" + +#: ../../../myst_parser/inventory.py:300 ../../../myst_parser/inventory.py:343 +msgid "Mapping of inventory name to inventory data" +msgstr "" + +#: ../../../myst_parser/inventory.py:301 ../../../myst_parser/inventory.py:344 +msgid "the inventory key filter" +msgstr "" + +#: ../../../myst_parser/inventory.py:302 ../../../myst_parser/inventory.py:345 +msgid "the domain name filter" +msgstr "" + +#: ../../../myst_parser/inventory.py:303 ../../../myst_parser/inventory.py:346 +msgid "the object type filter" +msgstr "" + +#: ../../../myst_parser/inventory.py:304 ../../../myst_parser/inventory.py:347 +msgid "the target name filter" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.rst:2 +msgid ":py:mod:`myst_parser.mdit_to_docutils`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/__init__.py:2 +msgid "Conversion of Markdown-it tokens to docutils AST." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/__init__.py:4 +msgid "" +"These renderers take the markdown-it parsed token stream and convert it " +"to the docutils AST. The sphinx renderer is a subclass of the docutils " +"one, with some additional methods only available *via* sphinx e.g. multi-" +"document cross-referencing." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:2 +msgid ":py:mod:`myst_parser.mdit_to_docutils.base`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:2 +msgid "Convert Markdown-it tokens to docutils nodes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:19 +msgid "" +":py:obj:`DocutilsRenderer " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:90 +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:27 +msgid "" +"A markdown-it-py renderer to populate (in-place) a `docutils.document` " +"AST." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:30 +msgid ":py:obj:`make_document `" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:62 +msgid "Create a new docutils document, with the parser classes' default settings." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:33 +msgid ":py:obj:`token_line `" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:81 +msgid "Retrieve the initial line of a token." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:36 +msgid "" +":py:obj:`html_meta_to_nodes " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1886 +msgid "" +"Replicate the `meta` directive, by converting a dictionary to a list of " +"pending meta nodes" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:39 +msgid ":py:obj:`clean_astext `" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1934 +msgid "Like node.astext(), but ignore images. Copied from sphinx." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:42 +msgid "" +":py:obj:`default_slugify " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1949 +msgid "Default slugify function." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:45 +msgid "" +":py:obj:`compute_unique_slug " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1960 +msgid "Compute the slug for a token." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:50 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:30 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:24 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:81 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:24 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:30 +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:24 +msgid "Data" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:56 +msgid ":py:obj:`REGEX_SCHEME `" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:68 +msgid "" +"RFC 7595: A non-empty scheme component followed by a colon (:), " +"consisting of a sequence of characters beginning with a letter and " +"followed by any combination of letters, digits, plus (+), period (.), or " +"hyphen (-). Although schemes are case-insensitive, the canonical form is " +"lowercase and documents that specify schemes must do so with lowercase " +"letters." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:59 +msgid "" +":py:obj:`REGEX_URI_TEMPLATE " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:62 +msgid "" +":py:obj:`REGEX_DIRECTIVE_START " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.base.rst:100 +msgid "Bases: :py:obj:`markdown_it.renderer.RendererProtocol`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:92 +msgid "Note, this render is not dependent on Sphinx." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:98 +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:98 +msgid "Load the renderer (called by ``MarkdownIt``)" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:129 +msgid "Setup the renderer with per render variables." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:153 +msgid "Return the sphinx env, if using Sphinx." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:160 +#: ../../../myst_parser/warnings_.py:96 +msgid "Generate a warning, logging if it is necessary." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:162 +#: ../../../myst_parser/warnings_.py:98 +msgid "" +"If the warning type is listed in the ``suppress_warnings`` configuration," +" then ``None`` will be returned and no warning logged." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:209 +msgid "Run the render on a token stream." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:211 +msgid "list on block tokens to render" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:212 +msgid "params of parser instance" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:213 +msgid "" +"the markdown-it environment sandbox associated with the tokens, " +"containing additional metadata like reference info" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:285 +msgid "Render unparsed text (appending to the current node)." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:287 +msgid "the text to render" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:288 +msgid "the starting line number of the text, within the full source" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:289 +msgid "whether the text is inline or block" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:290 +msgid "If set, allow sections to be created as children of this node" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:291 +msgid "offset heading levels by this amount" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:336 +msgid "Context manager for temporarily setting the current node." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:347 +msgid "Render the children of a token." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:360 +msgid "Copy the line number and document source path to the docutils node." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:366 +msgid "" +"Copy the line number and document source path to the docutils nodes, and " +"recursively to all descendants." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:377 +msgid "Copy attributes on the token to the docutils node." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:379 +msgid "the token to copy attributes from" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:380 +msgid "the node to copy attributes to" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:381 +msgid "the keys to copy from the token (after aliasing)" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:382 +msgid "a dictionary of converters for the attributes" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:383 +msgid "a dictionary mapping the token key name to the node key name" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:422 +msgid "Update the section level state, with the new current section and level." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:457 +msgid "Special kludge for image `alt` attributes to conform CommonMark spec." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:459 +msgid "" +"Don't try to use it! Spec requires to show `alt` content with stripped " +"markup, instead of simple escaping." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:590 +msgid "Create a literal block with syntax highlighting." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:592 +msgid "This mimics the behaviour of the `code-block` directive." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:594 +msgid "" +"In docutils, this directive directly parses the text with the pygments " +"lexer, whereas in sphinx, the lexer name is only recorded as the " +"`language` attribute, and the text is lexed later by pygments within the " +"`visit_literal_block` method of the output format ``SphinxTranslator``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:599 +msgid "Note, this function does not add the literal block to the document." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:698 +msgid "Render a fenced code block." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:750 +msgid "" +"Only add mathjax ignore classes if using sphinx, and using the " +"``dollarmath`` extension, and ``myst_update_mathjax=True``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:760 +msgid "Generate a heading target, and add it to the document." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:806 +msgid "Render a heading, e.g. `# Heading`." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:858 +msgid "" +"Parse `` or `[text](link \"title\")` syntax to docutils " +"AST:" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:860 +msgid "If `myst_all_links_external` is True, forward to `render_link_url`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:861 +msgid "If the link token has a class attribute containing `external`," +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:862 +msgid "forward to `render_link_url`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:863 +msgid "If the link is an id link (e.g. `#id`), forward to `render_link_anchor`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:864 +msgid "" +"If the link has a schema, and the schema is in `url_schemes` (e.g. " +"`http:`), forward to `render_link_url`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:866 +msgid "If the link has an `inv:` schema, forward to `render_link_inventory`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:867 +msgid "If the link is an autolink/linkify type link, forward to `render_link_url`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:868 +msgid "Otherwise, forward to `render_link_internal`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:903 +msgid "" +"Render link token (including autolink and linkify), where the link has " +"been identified as an external URL." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:967 +msgid "Render a link token like ``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:977 +msgid "Render a link token like ``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:992 +msgid "Render link token like `[text](#target)`, to a local target." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py +msgid "target" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:994 +msgid "the target id, e.g. `#target`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1009 +msgid "" +"Render link token `[text](link \"title\")`, where the link has not been " +"identified as an external URL::" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1015 +msgid "`text` can contain nested syntax, e.g. `[**bold**](link \"title\")`." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1017 +msgid "Note, this is overridden by `SphinxRenderer`, to use `pending_xref` nodes." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1030 +msgid "Create a link to an inventory object." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1032 +msgid "" +"This assumes the href is of the form `:#`. The path" +" is of the form `::`, where each of the parts is " +"optional, hence `:#` is also valid. Each of the path " +"parts can contain the `*` wildcard, for example: " +"`:key:*:obj#targe*`. `\\*` is treated as a plain `*`." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1116 +msgid "Return inventory matches." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1118 +msgid "This will be overridden for sphinx, to use intersphinx config." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1197 +msgid "Render an inline span token." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1205 +msgid "Pass document front matter data." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1246 +msgid "Render each key/val pair as a docutils ``field_node``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1248 +msgid "" +"Bibliographic keys below will be parsed as Markdown, all others will be " +"left as literal text." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1251 +msgid "" +"The field list should be at the start of the document, and will then be " +"converted to a `docinfo` node during the " +"`docutils.docutils.transforms.frontmatter.DocInfo` transform (priority " +"340), and bibliographic keys (or their translation) will be converted to " +"nodes::" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1269 +msgid "" +"Also, the 'dedication' and 'abstract' will be placed outside the " +"`docinfo`, and so will always be shown in the document." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1272 +msgid "" +"If using sphinx, this `docinfo` node will later be extracted from the " +"AST, by the `DoctreeReadEvent` transform (priority 880), calling " +"`MetadataCollector.process_doc`. In this case keys and values will be " +"converted to strings and stored in `app.env.metadata[app.env.docname]`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1278 +msgid "" +"See https://www.sphinx-doc.org/en/master/usage/restructuredtext/field-" +"lists.html for docinfo fields used by sphinx." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1372 +msgid "Render a strikethrough token." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1430 +msgid "" +"Footnote references are added as auto-numbered, .i.e. `[^a]` is read as " +"rST `[#a]_`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1451 +msgid "Despite the name, this is actually a footnote definition, e.g. `[^a]: ...`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1525 +msgid "Render a div block, with ``:`` colon delimiters." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1551 +msgid "Render a definition list." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1610 +msgid "Render a field list." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1647 +msgid "Render the content of the token as restructuredtext." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1663 +msgid "Render special fenced code blocks as directives." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1665 +msgid "the token to render" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1666 +#: ../../../myst_parser/mdit_to_docutils/base.py:1689 +msgid "the name of the directive" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1667 +msgid "The remaining text on the same line as the directive name." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1687 +msgid "Run a directive and return the generated nodes." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1690 +#: ../../../myst_parser/parsers/directives.py:83 +msgid "" +"The text on the same line as the directive name. May be an argument or " +"body text, dependent on the directive" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1692 +#: ../../../myst_parser/parsers/directives.py:85 +msgid "All text after the first line. Can include options." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1693 +msgid "The line number of the first line" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1694 +msgid "" +"Additional options to add to the directive, above those parsed from the " +"content." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1809 +msgid "Render inline substitution {{key}}." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1813 +msgid "Render block substitution {{key}}." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1817 +msgid "Substitutions are rendered by:" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1819 +msgid "" +"Combining global substitutions with front-matter substitutions to create " +"a variable context (front-matter takes priority)" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1821 +msgid "Add the sphinx `env` to the variable context (if available)" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1822 +msgid "Create the string content with Jinja2 (passing it the variable context)" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1823 +msgid "" +"If the substitution is inline and not a directive, parse to nodes " +"ignoring block syntaxes (like lists or block-quotes), otherwise parse to " +"nodes with all syntax rules." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1889 +msgid "" +"See: https://www.sphinx-" +"doc.org/en/master/usage/restructuredtext/basics.html#html-metadata" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1951 +msgid "This aims to mimic the GitHub Markdown format, see:" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1953 +msgid "" +"https://github.com/jch/html-" +"pipeline/blob/master/lib/html/pipeline/toc_filter.rb" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1954 +msgid "https://gist.github.com/asabaylus/3071099" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/base.py:1962 +msgid "This directly mirrors the logic in `mdit_py_plugins.anchors_plugin`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:2 +msgid ":py:mod:`myst_parser.mdit_to_docutils.html_to_nodes`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/html_to_nodes.py:2 +#: ../../../myst_parser/mdit_to_docutils/html_to_nodes.py:48 +msgid "Convert HTML to docutils nodes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:19 +msgid "" +":py:obj:`make_error " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:22 +msgid "" +":py:obj:`default_html " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:25 +msgid "" +":py:obj:`html_to_nodes " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:36 +msgid "" +":py:obj:`OPTION_KEYS_IMAGE " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:39 +msgid "" +":py:obj:`OPTION_KEYS_ADMONITION " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.html_to_nodes.rst:42 +msgid ":py:obj:`RE_FLOW `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:2 +msgid ":py:mod:`myst_parser.mdit_to_docutils.sphinx_`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:2 +msgid "" +"Convert Markdown-it tokens to docutils nodes, including sphinx specific " +"elements." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:19 +msgid "" +":py:obj:`SphinxRenderer " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:30 +msgid ":py:obj:`LOGGER `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.sphinx_.rst:46 +msgid "Bases: :py:obj:`myst_parser.mdit_to_docutils.base.DocutilsRenderer`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:29 +msgid "" +"This is sub-class of `DocutilsRenderer` that handles sphinx specific " +"aspects, such as cross-referencing." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:127 +msgid "" +"Render link token `[text](link \"title\")`, where the link has not been " +"identified as an external URL." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:186 +msgid "Render math with referenceable labels, e.g. ``$a=1$ (label)``." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/sphinx_.py:202 +msgid "Renderer for the amsmath extension." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:2 +msgid ":py:mod:`myst_parser.mdit_to_docutils.transforms`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:2 +msgid "Directives that can be applied to both Sphinx and docutils." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:19 +msgid "" +":py:obj:`UnreferencedFootnotesDetector " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:19 +msgid "Detect unreferenced footnotes and emit warnings." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:22 +msgid "" +":py:obj:`SortFootnotes " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:70 +msgid "Sort auto-numbered, labelled footnotes by the order they are referenced." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:25 +msgid "" +":py:obj:`CollectFootnotes " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:99 +msgid "Transform to move footnotes to the end of the document, and sort by label." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:28 +msgid "" +":py:obj:`ResolveAnchorIds " +"`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:143 +msgid "Transform for resolving `[name](#id)` type links." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:38 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:60 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:82 +#: ../../../docs/apidocs/myst_parser/myst_parser.mdit_to_docutils.transforms.rst:104 +msgid "Bases: :py:obj:`docutils.transforms.Transform`" +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:21 +msgid "" +"Replicates https://github.com/sphinx-doc/sphinx/pull/12730, but also " +"allows for use in docutils (without sphinx)." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:42 +#: ../../../myst_parser/sphinx_ext/myst_refs.py:42 +msgid "Initial setup for in-place document transforms." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:30 +#: ../../../myst_parser/mdit_to_docutils/transforms.py:80 +#: ../../../myst_parser/mdit_to_docutils/transforms.py:106 +#: ../../../myst_parser/mdit_to_docutils/transforms.py:148 +msgid "Apply the transform." +msgstr "" + +#: ../../../myst_parser/mdit_to_docutils/transforms.py:72 +msgid "" +"This is run before the docutils ``Footnote`` transform, where numbered " +"labels are assigned." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:2 +msgid ":py:mod:`myst_parser.mocking`" +msgstr "" + +#: ../../../myst_parser/mocking.py:2 +msgid "" +"This module provides classes to Mock the core components of the " +"docutils.RSTParser, the key difference being that nested parsing treats " +"the text as Markdown not rST." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:19 +msgid ":py:obj:`MockInliner `" +msgstr "" + +#: ../../../myst_parser/mocking.py:33 +msgid "A mock version of `docutils.parsers.rst.states.Inliner`." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:22 +msgid ":py:obj:`MockState `" +msgstr "" + +#: ../../../myst_parser/mocking.py:96 +msgid "A mock version of `docutils.parsers.rst.states.RSTState`." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:25 +msgid ":py:obj:`MockStateMachine `" +msgstr "" + +#: ../../../myst_parser/mocking.py:312 +msgid "A mock version of `docutils.parsers.rst.states.RSTStateMachine`." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:28 +msgid ":py:obj:`MockIncludeDirective `" +msgstr "" + +#: ../../../myst_parser/mocking.py:346 +msgid "" +"This directive uses a lot of statemachine logic that is not yet mocked. " +"Therefore, we treat it as a special case (at least for now)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:31 +msgid ":py:obj:`MockRSTParser `" +msgstr "" + +#: ../../../myst_parser/mocking.py:542 +msgid "RSTParser which avoids a negative side effect." +msgstr "" + +#: ../../../myst_parser/mocking.py:29 +msgid "An exception to signal an error during mocking of docutils components." +msgstr "" + +#: ../../../myst_parser/mocking.py:35 +msgid "This is parsed to role functions." +msgstr "" + +#: ../../../myst_parser/mocking.py:39 +msgid "Initialize the mock inliner." +msgstr "" + +#: ../../../myst_parser/mocking.py:55 +msgid "Record a system message from parsing." +msgstr "" + +#: ../../../myst_parser/mocking.py:65 +msgid "Parse the text and return a list of nodes." +msgstr "" + +#: ../../../myst_parser/mocking.py:98 +msgid "" +"This is parsed to the `Directives.run()` method, so that they may run " +"nested parses on their content that will be parsed as markdown, rather " +"than RST." +msgstr "" + +#: ../../../myst_parser/mocking.py:128 +msgid "Parse the full directive text" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst +msgid "Raises" +msgstr "" + +#: ../../../myst_parser/mocking.py:130 +msgid "for errors in parsing the directive" +msgstr "" + +#: ../../../myst_parser/mocking.py:131 +msgid "(arguments, options, content, content_offset)" +msgstr "" + +#: ../../../myst_parser/mocking.py:154 +msgid "Perform a nested parse of the input block, with ``node`` as the parent." +msgstr "" + +#: ../../../myst_parser/mocking.py:156 +msgid "The block of lines to parse." +msgstr "" + +#: ../../../myst_parser/mocking.py:157 +msgid "" +"The offset of the first line of block, to the starting line of the state " +"(i.e. directive)." +msgstr "" + +#: ../../../myst_parser/mocking.py:159 +msgid "The parent node to attach the parsed content to." +msgstr "" + +#: ../../../myst_parser/mocking.py:160 +msgid "" +"Whether to to allow the parsing of headings (normally this is false, " +"since nested heading would break the document structure)" +msgstr "" + +#: ../../../myst_parser/mocking.py:182 +msgid "" +"Taken from https://github.com/docutils-" +"mirror/docutils/blob/e88c5fb08d5cdfa8b4ac1020dd6f7177778d5990/docutils/parsers/rst/states.py#L1927" +msgstr "" + +#: ../../../myst_parser/mocking.py:195 +msgid "Parse text with only inline rules." +msgstr "" + +#: ../../../myst_parser/mocking.py:197 +msgid "(list of nodes, list of messages)" +msgstr "" + +#: ../../../myst_parser/mocking.py:207 +msgid "" +"Parse a block quote, which is a block of text, followed by an (optional) " +"attribution." +msgstr "" + +#: ../../../myst_parser/mocking.py:268 +msgid "Modify the line block element in-place, to nest line block segments." +msgstr "" + +#: ../../../myst_parser/mocking.py:270 +msgid "" +"Line nodes are placed into child line block containers, based on their " +"indentation." +msgstr "" + +#: ../../../myst_parser/mocking.py:314 +msgid "This is parsed to the `Directives.run()` method." +msgstr "" + +#: ../../../myst_parser/mocking.py:327 +msgid "Return document source path." +msgstr "" + +#: ../../../myst_parser/mocking.py:331 +msgid "Return (source path, line) tuple for current or given line number." +msgstr "" + +#: ../../../myst_parser/mocking.py:349 +msgid "" +"See: https://docutils.sourceforge.io/docs/ref/rst/directives.html" +"#including-an-external-document-fragment" +msgstr "" + +#: ../../../myst_parser/mocking.py:529 +msgid "Append self.options['name'] to node['names'] if it exists." +msgstr "" + +#: ../../../myst_parser/mocking.py:531 +msgid "Also normalize the name string and register it as explicit target." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.mocking.rst:164 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:123 +msgid "Bases: :py:obj:`docutils.parsers.rst.Parser`" +msgstr "" + +#: ../../../myst_parser/mocking.py:545 +msgid "Parse the input to populate the document AST." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.rst:2 +msgid ":py:mod:`myst_parser.parsers`" +msgstr "" + +#: ../../../myst_parser/parsers/__init__.py:2 +msgid "Parsers of MyST Markdown source text to docutils AST." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:2 +msgid ":py:mod:`myst_parser.parsers.directives`" +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:2 +msgid "" +"Fenced code blocks are parsed as directives, if the block starts with " +"``{directive_name}``, followed by arguments on the same line." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:6 +msgid "" +"Directive options are read from a YAML block, if the first content line " +"starts with ``---``, e.g." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:20 +msgid "" +"Or the option block will be parsed if the first content line starts with " +"``:``, as a YAML block consisting of every line that starts with a ``:``," +" e.g." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:32 +msgid "" +"If the first line of a directive's content is blank, this will be " +"stripped from the content. This is to allow for separation between the " +"option block and content." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:19 +msgid ":py:obj:`ParseWarnings `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:22 +msgid "" +":py:obj:`DirectiveParsingResult " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:33 +msgid "" +":py:obj:`parse_directive_text " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:81 +msgid "Parse (and validate) the full directive text." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.directives.rst:36 +msgid "" +":py:obj:`parse_directive_arguments " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:311 +msgid "Parse (and validate) the directive argument section." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:67 +msgid "The arguments parsed from the first line." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:69 +msgid "Options parsed from the YAML block." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:71 +msgid "The lines of body content" +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:73 +msgid "The number of lines to the start of the body content." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:75 +msgid "" +"List of non-fatal errors encountered during parsing. (message, " +"line_number)" +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:86 +msgid "" +"Whether to validate the values of options This is actually only here to " +"be used by myst-nb cells, which converts options directly to JSON " +"metadata, using the full YAML spec." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:89 +msgid "" +"Additional options to add to the directive, above those parsed from the " +"content (content options take priority)." +msgstr "" + +#: ../../../myst_parser/parsers/directives.py:92 +msgid "if there is a fatal parsing/validation error" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:2 +msgid ":py:mod:`myst_parser.parsers.docutils_`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:2 +msgid "MyST Markdown parser for docutils." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:19 +msgid ":py:obj:`Unset `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:73 +msgid "A sentinel class for unset settings." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:22 +msgid ":py:obj:`Parser `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:237 +msgid "Docutils parser for Markedly Structured Text (MyST)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:25 +msgid "" +":py:obj:`SimpleTranslator " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:27 +msgid ":py:obj:`SimpleWriter `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:37 +msgid "" +":py:obj:`attr_to_optparse_option " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:192 +msgid "Convert an ``MdParserConfig`` attribute into a Docutils setting tuple." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:40 +msgid "" +":py:obj:`create_myst_settings_spec " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:210 +msgid "Return a list of Docutils setting for the docutils MyST section." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:43 +msgid "" +":py:obj:`create_myst_config " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:220 +msgid "Create a configuration instance from the given settings." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:46 +msgid ":py:obj:`cli_html `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:365 +msgid "Cmdline entrypoint for converting MyST to HTML." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:49 +msgid ":py:obj:`cli_html5 `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:370 +msgid "Cmdline entrypoint for converting MyST to HTML5." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:52 +msgid ":py:obj:`cli_html5_demo `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:375 +msgid "Cmdline entrypoint for converting MyST to simple HTML5 demonstrations." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:55 +msgid ":py:obj:`to_html5_demo `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:396 +msgid "Convert a MyST string to HTML5." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:58 +msgid ":py:obj:`cli_latex `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:413 +msgid "Cmdline entrypoint for converting MyST to LaTeX." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:61 +msgid ":py:obj:`cli_xml `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:418 +msgid "Cmdline entrypoint for converting MyST to XML." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:64 +msgid ":py:obj:`cli_pseudoxml `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:423 +msgid "Cmdline entrypoint for converting MyST to pseudo-XML." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:67 +msgid "" +":py:obj:`visit_rubric_html " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:428 +#: ../../../myst_parser/parsers/docutils_.py:489 +msgid "Override the default HTML visit method for rubric nodes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:70 +msgid "" +":py:obj:`depart_rubric_html " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:73 +msgid "" +":py:obj:`visit_container_html " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:500 +msgid "Override the default HTML visit method for container nodes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:76 +msgid "" +":py:obj:`depart_container_html " +"`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:516 +msgid "Override the default HTML depart method for container nodes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:87 +msgid ":py:obj:`DOCUTILS_UNSET `" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:84 +msgid "Sentinel for arguments not set through docutils.conf." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:194 +msgid "A tuple of ``(help string, option flags, optparse kwargs)``." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:240 +#: ../../../myst_parser/parsers/sphinx_.py:33 +msgid "Aliases this parser supports." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:243 +#: ../../../myst_parser/parsers/sphinx_.py:36 +msgid "Runtime settings specification." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:263 +#: ../../../myst_parser/parsers/sphinx_.py:61 +msgid "Parse source text." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:265 +#: ../../../myst_parser/parsers/sphinx_.py:63 +msgid "The source string to parse" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:266 +#: ../../../myst_parser/parsers/sphinx_.py:64 +msgid "The root docutils node to add AST elements to" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:173 +msgid "Bases: :py:obj:`docutils.writers.html5_polyglot.HTMLTranslator`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.docutils_.rst:181 +msgid "Bases: :py:obj:`docutils.writers.html5_polyglot.Writer`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:377 +msgid "" +"This is a special case of the HTML5 writer, that only outputs the body of" +" the document." +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:430 +msgid "" +"docutils structures a document, based on the headings, into nested " +"sections::" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:446 +msgid "" +"This means that it is not possible to have \"standard\" headings nested " +"inside other components, such as blockquotes, because it would break the " +"structure::" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:464 +msgid "" +"we work around this shortcoming, in `DocutilsRenderer.render_heading`, by" +" identifying if a heading is inside another component and instead " +"outputting it as a \"non-structural\" rubric node, and capture the " +"level::" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:478 +msgid "" +"However, docutils natively just outputs rubrics as

tags, and does not" +" \"honor\" the heading level. So here we override the visit/depart " +"methods to output the correct element" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:491 +msgid "See explanation in `visit_rubric_html`" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:502 +msgid "" +"to remove the \"container\" class for divs this avoids CSS clashes with " +"the bootstrap theme" +msgstr "" + +#: ../../../myst_parser/parsers/docutils_.py:518 +msgid "See explanation in `visit_container_html`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.mdit.rst:2 +msgid ":py:mod:`myst_parser.parsers.mdit`" +msgstr "" + +#: ../../../myst_parser/parsers/mdit.py:2 +msgid "" +"This module holds the ``create_md_parser`` function, which creates a " +"parser from the config." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.mdit.rst:19 +msgid ":py:obj:`create_md_parser `" +msgstr "" + +#: ../../../myst_parser/parsers/mdit.py:30 +msgid "Return a Markdown parser with the required MyST configuration." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:2 +msgid ":py:mod:`myst_parser.parsers.options`" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:2 +msgid "Parser for directive options." +msgstr "" + +#: ../../../myst_parser/parsers/options.py:4 +msgid "" +"This is a highly restricted parser for YAML, which only allows a subset " +"of YAML to be used for directive options:" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:7 +msgid "Only block mappings are allowed at the top level" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:8 +msgid "Mapping keys are parsed as strings (plain or quoted)" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:9 +msgid "" +"Mapping values are parsed as strings (plain, quoted, literal `|`, folded " +"`>`)" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:10 +msgid "`#` Comments are allowed and blank lines" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:12 +msgid "" +"Adapted from: " +"https://github.com/yaml/pyyaml/commit/957ae4d495cf8fcb5475c6c2f1bce801096b68a5" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:15 +msgid "" +"For a good description of multi-line YAML strings, see: " +"https://stackoverflow.com/a/21699210/5033292" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:19 +msgid ":py:obj:`Position `" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:28 +msgid "Position of a character in a stream." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:22 +msgid ":py:obj:`StreamBuffer `" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:36 +msgid "A buffer for a stream of characters." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:25 +msgid ":py:obj:`Token `" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:81 +msgid "A parsed token from a directive option stream." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:28 +msgid ":py:obj:`KeyToken `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:30 +msgid ":py:obj:`ValueToken `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:32 +msgid ":py:obj:`ColonToken `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:34 +msgid ":py:obj:`State `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:45 +msgid ":py:obj:`options_to_items `" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:174 +msgid "Parse a directive option block into (key, value) tuples." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:154 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:180 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.options.rst:206 +msgid "Bases: :py:obj:`myst_parser.parsers.options.Token`" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:93 +#: ../../../myst_parser/parsers/options.py:101 +msgid "The original style of the string." +msgstr "" + +#: ../../../myst_parser/parsers/options.py:130 +msgid "Clone the error with the given line and column offsets." +msgstr "" + +#: ../../../myst_parser/parsers/options.py:176 +msgid "The directive option text." +msgstr "" + +#: ../../../myst_parser/parsers/options.py:177 +msgid "The line offset to apply to the error positions." +msgstr "" + +#: ../../../myst_parser/parsers/options.py:178 +msgid "The column offset to apply to the error positions." +msgstr "" + +#: ../../../myst_parser/parsers/options.py +msgid "raises" +msgstr "" + +#: ../../../myst_parser/parsers/options.py:180 +msgid "`TokenizeError`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:2 +msgid ":py:mod:`myst_parser.parsers.parse_html`" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:2 +msgid "A simple but complete HTML to Abstract Syntax Tree (AST) parser." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:4 +msgid "The AST can also reproduce the HTML text." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:6 +#: ../../../myst_parser/sphinx_ext/directives.py:44 +msgid "Example::" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:17 +msgid "" +"Note: optional tags are not accounted for (see " +"https://html.spec.whatwg.org/multipage/syntax.html#optional-tags)" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:19 +msgid ":py:obj:`Attribute `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:33 +msgid "This class holds the tags's attributes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:22 +msgid ":py:obj:`Element `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:50 +msgid "An Element of the xml/html document." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:25 +msgid ":py:obj:`Root `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:202 +msgid "The root of the AST tree." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:28 +msgid ":py:obj:`Tag `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:210 +msgid "" +"Represent xml/html tags under the form: ... " +"." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:31 +msgid ":py:obj:`XTag `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:229 +msgid "Represent XHTML style tags with no children, like ``" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:34 +msgid ":py:obj:`VoidTag `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:242 +msgid "" +"Represent tags with no children, only start tag, like ``" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:37 +msgid ":py:obj:`TerminalElement `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:39 +msgid ":py:obj:`Data `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:266 +msgid "Represent data inside xml/html documents, like raw text." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:42 +msgid ":py:obj:`Declaration `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:273 +msgid "Represent declarations, like ``" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:45 +msgid ":py:obj:`Comment `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:280 +msgid "Represent HTML comments" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:48 +msgid ":py:obj:`Pi `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:287 +msgid "Represent processing instructions like ``" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:51 +msgid ":py:obj:`Char `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:294 +msgid "Represent character codes like: `�`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:54 +msgid ":py:obj:`Entity `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:301 +msgid "Represent entities like `&`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:57 +msgid ":py:obj:`Tree `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:308 +msgid "The engine class to generate the AST tree." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:60 +msgid ":py:obj:`HtmlToAst `" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:373 +msgid "The tokenizer class." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:71 +msgid ":py:obj:`tokenize_html `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:81 +msgid "Bases: :py:obj:`dict`" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:41 +msgid "Return 'class' attribute as list." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:98 +msgid "Bases: :py:obj:`collections.abc.MutableSequence`" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:52 +msgid "All xml/html entities inherit from this class." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:56 +msgid "Initialise the element." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:64 +msgid "Return parent." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:69 +msgid "Return copy of children." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:112 +msgid "Recursively copy and remove parent." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:127 +msgid "Returns a HTML string representation of the element." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:129 +msgid "" +"Provide a dictionary of render function for specific tag names, to " +"override the normal render format" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:146 +msgid "Walk through the xml/html AST." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:154 +msgid "" +"Return copy with all `Data` tokens that only contain whitespace / " +"newlines removed." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:173 +msgid "Find all elements that match name and specific attributes." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:155 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:171 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:185 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:199 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:213 +msgid "Bases: :py:obj:`myst_parser.parsers.parse_html.Element`" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:205 +msgid "Returns a string HTML representation of the structure." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:260 +msgid "Copy and remove parent." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:223 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:237 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:251 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:265 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:279 +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:293 +msgid "Bases: :py:obj:`myst_parser.parsers.parse_html.TerminalElement`" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:311 +msgid "Initialise Tree" +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:318 +msgid "Clear the outmost and stack for a new parsing." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:324 +msgid "Return the last pointer which point to the actual tag scope." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:328 +msgid "Nest a given tag at the bottom of the tree using the last stack's pointer." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:338 +msgid "Nest an XTag onto the tree." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:344 +msgid "Nest a VoidTag onto the tree." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:350 +msgid "Nest the data onto the tree." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:356 +msgid "" +"When a closing tag is found, pop the pointer's scope from the stack, to " +"then point to the earlier scope's tag." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:351 +msgid "Bases: :py:obj:`html.parser.HTMLParser`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:357 +msgid "Initialize and reset this instance." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.parse_html.rst:357 +msgid "" +"If convert_charrefs is True (the default), all character references are " +"automatically converted to the corresponding Unicode characters." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:398 +msgid "Parse the source string." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:404 +msgid "When found an opening tag then nest it onto the tree." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:411 +msgid "When found a XHTML tag style then nest it up to the tree." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:415 +msgid "When found a closing tag then makes it point to the right scope." +msgstr "" + +#: ../../../myst_parser/parsers/parse_html.py:420 +msgid "Nest data onto the tree." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:2 +msgid ":py:mod:`myst_parser.parsers.sphinx_`" +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:2 +msgid "MyST Markdown parser for sphinx." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:19 +msgid ":py:obj:`MystParser `" +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:30 +msgid "Sphinx parser for Markedly Structured Text (MyST)." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:30 +msgid ":py:obj:`SPHINX_LOGGER `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.parsers.sphinx_.rst:46 +msgid "Bases: :py:obj:`sphinx.parsers.Parser`" +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:38 +msgid "" +"Defines runtime settings and associated command-line options, as used by " +"`docutils.frontend.OptionParser`. This is a concatenation of tuples of:" +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:41 +msgid "" +"Option group title (string or `None` which implies no group, just a list " +"of single options)." +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:44 +msgid "Description (string or `None`)." +msgstr "" + +#: ../../../myst_parser/parsers/sphinx_.py:46 +msgid "A sequence of option tuples" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_.rst:2 +msgid ":py:mod:`myst_parser.sphinx_`" +msgstr "" + +#: ../../../myst_parser/sphinx_.py:2 +msgid "" +"A module for compatibility with the docutils>=0.17 `include` directive, " +"in RST documents." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.rst:2 +msgid ":py:mod:`myst_parser.sphinx_ext`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/__init__.py:2 +msgid "Sphinx extension for myst_parser." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:2 +msgid ":py:mod:`myst_parser.sphinx_ext.directives`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/directives.py:2 +msgid "MyST specific directives" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:19 +msgid "" +":py:obj:`SubstitutionReferenceRole " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/directives.py:29 +msgid "Implement substitution references as a role." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:22 +msgid "" +":py:obj:`FigureMarkdown " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/directives.py:42 +msgid "Directive for creating a figure with Markdown compatible syntax." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:33 +msgid ":py:obj:`align `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:36 +msgid "" +":py:obj:`figwidth_value " +"`" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:56 +msgid "Bases: :py:obj:`sphinx.util.docutils.SphinxRole`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/directives.py:31 +msgid "Note, in ``docutils/parsers/rst/roles.py`` this is left unimplemented." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.directives.rst:68 +msgid "Bases: :py:obj:`sphinx.util.docutils.SphinxDirective`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/directives.py:132 +msgid "A warning for reporting an invalid figure." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:2 +msgid ":py:mod:`myst_parser.sphinx_ext.main`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:2 +msgid "The setup for the sphinx extension." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:19 +msgid ":py:obj:`setup_sphinx `" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:24 +msgid "Initialize all settings and transforms in Sphinx." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.main.rst:22 +msgid "" +":py:obj:`create_myst_config " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:81 +msgid "Create the myst config object and add it to the sphinx environment." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:26 +msgid "The Sphinx application object." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:27 +msgid "Whether to load the parser." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:2 +msgid ":py:mod:`myst_parser.sphinx_ext.mathjax`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:2 +msgid "Overrides to ``sphinx.ext.mathjax``" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:4 +msgid "This fixes two issues:" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:6 +msgid "" +"Mathjax should not search for ``$`` delimiters, nor LaTeX amsmath " +"environments, since we already achieve this with the dollarmath and " +"amsmath mrakdown-it-py plugins" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:8 +msgid "" +"amsmath math blocks should be wrapped in mathjax delimiters (default " +"``\\[...\\]``), and assigned an equation number" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:19 +msgid "" +":py:obj:`log_override_warning " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:25 +msgid "Log a warning if MathJax configuration being overridden." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:22 +msgid "" +":py:obj:`override_mathjax " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:41 +msgid "Override aspects of the mathjax extension." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:25 +msgid "" +":py:obj:`html_visit_displaymath " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:97 +msgid "Override for sphinx.ext.mathjax.html_visit_displaymath to handle amsmath." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.mathjax.rst:36 +msgid ":py:obj:`logger `" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:43 +msgid "" +"MyST-Parser parses dollar and latex math, via markdown-it plugins. " +"Therefore, we tell Mathjax to only render these HTML elements. This is " +"accompanied by setting the `ignoreClass` on the top-level section of each" +" MyST document." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/mathjax.py:99 +msgid "" +"By default displaymath, are normally wrapped in a prefix/suffix, defined " +"by mathjax_display, and labelled nodes are numbered. However, this is not" +" the case if the math_block is set as 'nowrap', as for amsmath. " +"Therefore, we need to override this behaviour." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:2 +msgid ":py:mod:`myst_parser.sphinx_ext.myst_refs`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:2 +msgid "" +"A post-transform for overriding the behaviour of sphinx reference " +"resolution." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:4 +msgid "" +"This is applied to MyST type references only, such as ``[text](target)``," +" and allows for nested syntax" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:19 +msgid "" +":py:obj:`MystReferenceResolver " +"`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:33 +msgid "Resolves cross-references on doctrees." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:30 +msgid ":py:obj:`LOGGER `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.sphinx_ext.myst_refs.rst:46 +msgid "Bases: :py:obj:`sphinx.transforms.post_transforms.ReferencesResolver`" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:35 +msgid "Overrides default sphinx implementation, to allow for nested syntax" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:41 +msgid "Log a warning, with a myst type and specific subtype." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:131 +msgid "" +"Resolve a reference, from a markdown link, to another document, " +"optionally with a target id within that document." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:187 +msgid "Resolve reference generated by the \"myst\" role; ``[text](#reference)``." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:189 +msgid "This builds on the sphinx ``any`` role to also resolve:" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:191 +msgid "Document references with extensions; ``[text](./doc.md)``" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:192 +msgid "Document references with anchors with anchors; ``[text](./doc.md#target)``" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/myst_refs.py:193 +msgid "" +"Nested syntax for explicit text with std:doc and std:ref; " +"``[**nested**](reference)``" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:2 +msgid ":py:mod:`myst_parser.warnings_`" +msgstr "" + +#: ../../../myst_parser/warnings_.py:2 +msgid "Central handling of warnings for the myst extension." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:19 +msgid ":py:obj:`MystWarnings `" +msgstr "" + +#: ../../../myst_parser/warnings_.py:13 +msgid "MyST warning types." +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:30 +msgid ":py:obj:`create_warning `" +msgstr "" + +#: ../../../docs/apidocs/myst_parser/myst_parser.warnings_.rst:40 +msgid "Bases: :py:obj:`enum.Enum`" +msgstr "" + +#: ../../../myst_parser/warnings_.py:16 +msgid "Deprecated usage." +msgstr "" + +#: ../../../myst_parser/warnings_.py:18 +msgid "Functionality that is not yet supported in docutils." +msgstr "" + +#: ../../../myst_parser/warnings_.py:21 +msgid "The render method is not implemented." +msgstr "" + +#: ../../../myst_parser/warnings_.py:24 +msgid "Issue reading front-matter." +msgstr "" + +#: ../../../myst_parser/warnings_.py:26 +msgid "Duplicate Markdown reference definition." +msgstr "" + +#: ../../../myst_parser/warnings_.py:28 +msgid "Non-consecutive heading levels." +msgstr "" + +#: ../../../myst_parser/warnings_.py:31 +msgid "Issue parsing directive." +msgstr "" + +#: ../../../myst_parser/warnings_.py:33 +msgid "Issue parsing directive options." +msgstr "" + +#: ../../../myst_parser/warnings_.py:35 +msgid "" +"Directive options has # comments, which may not be supported in future " +"versions." +msgstr "" + +#: ../../../myst_parser/warnings_.py:37 +msgid "Issue parsing directive body." +msgstr "" + +#: ../../../myst_parser/warnings_.py:39 +msgid "Unknown directive." +msgstr "" + +#: ../../../myst_parser/warnings_.py:41 +msgid "Unknown role." +msgstr "" + +#: ../../../myst_parser/warnings_.py:45 +msgid "Multiple targets were found for a cross-reference." +msgstr "" + +#: ../../../myst_parser/warnings_.py:47 +msgid "A target was not found for a cross-reference." +msgstr "" + +#: ../../../myst_parser/warnings_.py:49 +msgid "Failure to retrieve or load an inventory." +msgstr "" + +#: ../../../myst_parser/warnings_.py:51 +msgid "A target was not found for an inventory reference." +msgstr "" + +#: ../../../myst_parser/warnings_.py:53 +msgid "Multiple targets were found for an inventory reference." +msgstr "" + +#: ../../../myst_parser/warnings_.py:55 +msgid "A legacy domain found, which does not support `resolve_any_xref`." +msgstr "" + +#: ../../../myst_parser/warnings_.py:59 +msgid "An error occurred computing a heading slug." +msgstr "" + +#: ../../../myst_parser/warnings_.py:61 +msgid "Strikethrough warning, since only implemented in HTML." +msgstr "" + +#: ../../../myst_parser/warnings_.py:63 +msgid "HTML could not be parsed." +msgstr "" + +#: ../../../myst_parser/warnings_.py:65 +msgid "Invalid attribute value." +msgstr "" + +#: ../../../myst_parser/warnings_.py:67 +msgid "Substitution could not be resolved." +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/configuration.po b/locales/zh_CN/LC_MESSAGES/configuration.po new file mode 100644 index 00000000..8e346942 --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/configuration.po @@ -0,0 +1,788 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/configuration.md:2 +msgid "Configuration" +msgstr "" + +#: ../../../docs/configuration.md:4 +msgid "" +"MyST parsing can be configured at both the global and individual document" +" level, with the most specific configuration taking precedence." +msgstr "" + +#: ../../../docs/configuration.md:7 +msgid "Global configuration" +msgstr "" + +#: ../../../docs/configuration.md:9 +msgid "" +"Overriding the default configuration at the global level is achieved by " +"specifying variables in the Sphinx `conf.py` file. All `myst_parser` " +"global configuration variables are prefixed with `myst_`, e.g." +msgstr "" + +#: ../../../docs/configuration.md:17 +msgid "Configuration in Docutils, in the [](docutils.md) section." +msgstr "" + +#: ../../../docs/configuration.md:25 ../../../docs/configuration.md:34 +#: ../../../docs/configuration.md:72 ../../../docs/configuration.md:147 +msgid "Name" +msgstr "" + +#: ../../../docs/configuration.md:26 ../../../docs/configuration.md:35 +#: ../../../docs/configuration.md:73 ../../../docs/configuration.md:148 +msgid "Type" +msgstr "" + +#: ../../../docs/configuration.md:27 ../../../docs/configuration.md:36 +#: ../../../docs/configuration.md:74 ../../../docs/configuration.md:149 +msgid "Description" +msgstr "" + +#: ../../../docs/configuration.md:28 +msgid "`myst_commonmark_only`" +msgstr "" + +#: ../../../docs/configuration.md:29 ../../../docs/configuration.md:32 +#: ../../../docs/configuration.md:41 ../../../docs/configuration.md:44 +#: ../../../docs/configuration.md:47 ../../../docs/configuration.md:50 +#: ../../../docs/configuration.md:53 ../../../docs/configuration.md:56 +#: ../../../docs/configuration.md:59 ../../../docs/configuration.md:65 +#: ../../../docs/configuration.md:71 ../../../docs/configuration.md:74 +#: ../../../docs/configuration.md:76 ../../../docs/configuration.md:79 +#: ../../../docs/configuration.md:88 ../../../docs/configuration.md:91 +#: ../../../docs/configuration.md:106 ../../../docs/configuration.md:115 +#: ../../../docs/configuration.md:118 ../../../docs/configuration.md:157 +#: ../../../docs/configuration.md:160 ../../../docs/configuration.md:163 +#: ../../../docs/configuration.md:166 ../../../docs/configuration.md:169 +#: ../../../docs/configuration.md:172 +msgid "`bool`" +msgstr "" + +#: ../../../docs/configuration.md:30 ../../../docs/configuration.md:77 +msgid "Use strict CommonMark parser (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:31 +msgid "`myst_gfm_only`" +msgstr "" + +#: ../../../docs/configuration.md:33 ../../../docs/configuration.md:80 +msgid "Use strict Github Flavoured Markdown parser (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:34 +msgid "`myst_enable_extensions`" +msgstr "" + +#: ../../../docs/configuration.md:35 ../../../docs/configuration.md:53 +#: ../../../docs/configuration.md:82 ../../../docs/configuration.md:100 +msgid "`set[str]`" +msgstr "" + +#: ../../../docs/configuration.md:36 ../../../docs/configuration.md:83 +msgid "Enable syntax extensions (default: `set()`)" +msgstr "" + +#: ../../../docs/configuration.md:37 +msgid "`myst_disable_syntax`" +msgstr "" + +#: ../../../docs/configuration.md:38 ../../../docs/configuration.md:85 +msgid "`collections.abc.Iterable[str]`" +msgstr "" + +#: ../../../docs/configuration.md:39 ../../../docs/configuration.md:86 +msgid "Disable Commonmark syntax elements (default: `[]`)" +msgstr "" + +#: ../../../docs/configuration.md:40 +msgid "`myst_all_links_external`" +msgstr "" + +#: ../../../docs/configuration.md:42 ../../../docs/configuration.md:89 +msgid "Parse all links as simple hyperlinks (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:43 +msgid "`myst_links_external_new_tab`" +msgstr "" + +#: ../../../docs/configuration.md:45 ../../../docs/configuration.md:92 +msgid "Open all external links in a new tab (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:46 +msgid "`myst_url_schemes`" +msgstr "" + +#: ../../../docs/configuration.md:47 ../../../docs/configuration.md:94 +msgid "`list[str] | dict[str, None | str | dict]`" +msgstr "" + +#: ../../../docs/configuration.md:48 ../../../docs/configuration.md:95 +msgid "" +"URI schemes that are converted to external links (default: `{'http': " +"None, 'https': None, 'mailto': None, 'ftp': None}`)" +msgstr "" + +#: ../../../docs/configuration.md:49 +msgid "`myst_ref_domains`" +msgstr "" + +#: ../../../docs/configuration.md:50 ../../../docs/configuration.md:97 +msgid "`collections.abc.Iterable[str] | None`" +msgstr "" + +#: ../../../docs/configuration.md:51 ../../../docs/configuration.md:98 +msgid "Sphinx domain names to search in for link references (default: `None`)" +msgstr "" + +#: ../../../docs/configuration.md:52 +msgid "`myst_fence_as_directive`" +msgstr "" + +#: ../../../docs/configuration.md:54 ../../../docs/configuration.md:101 +msgid "" +"Interpret a code fence as a directive, for certain language names. This " +"can be useful for fences like dot and mermaid, and interoperability with " +"other Markdown renderers. (default: `set()`)" +msgstr "" + +#: ../../../docs/configuration.md:55 +msgid "`myst_number_code_blocks`" +msgstr "" + +#: ../../../docs/configuration.md:56 ../../../docs/configuration.md:103 +msgid "`collections.abc.Sequence[str]`" +msgstr "" + +#: ../../../docs/configuration.md:57 ../../../docs/configuration.md:104 +msgid "Add line numbers to code blocks with these languages (default: `[]`)" +msgstr "" + +#: ../../../docs/configuration.md:58 +msgid "`myst_title_to_header`" +msgstr "" + +#: ../../../docs/configuration.md:60 ../../../docs/configuration.md:107 +msgid "" +"Convert a `title` field in the front-matter to a H1 header (default: " +"`False`)" +msgstr "" + +#: ../../../docs/configuration.md:61 +msgid "`myst_heading_anchors`" +msgstr "" + +#: ../../../docs/configuration.md:62 ../../../docs/configuration.md:77 +#: ../../../docs/configuration.md:109 ../../../docs/configuration.md:121 +msgid "`int`" +msgstr "" + +#: ../../../docs/configuration.md:63 ../../../docs/configuration.md:110 +msgid "Heading level depth to assign HTML anchors (default: `0`)" +msgstr "" + +#: ../../../docs/configuration.md:64 +msgid "`myst_heading_slug_func`" +msgstr "" + +#: ../../../docs/configuration.md:65 +msgid "`None | Callable[[str], str] | str`" +msgstr "" + +#: ../../../docs/configuration.md:66 +msgid "" +"Function for creating heading anchors, or a python import path e.g. " +"`my_package.my_module.my_function` (default: `None`)" +msgstr "" + +#: ../../../docs/configuration.md:67 +msgid "`myst_html_meta`" +msgstr "" + +#: ../../../docs/configuration.md:68 ../../../docs/configuration.md:112 +msgid "`dict[str, str]`" +msgstr "" + +#: ../../../docs/configuration.md:69 ../../../docs/configuration.md:113 +msgid "HTML meta tags (default: `{}`)" +msgstr "" + +#: ../../../docs/configuration.md:70 +msgid "`myst_footnote_sort`" +msgstr "" + +#: ../../../docs/configuration.md:72 ../../../docs/configuration.md:116 +msgid "" +"Move all footnotes to the end of the document, and sort by reference " +"order (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:73 +msgid "`myst_footnote_transition`" +msgstr "" + +#: ../../../docs/configuration.md:75 ../../../docs/configuration.md:119 +msgid "Place a transition before sorted footnotes (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:76 +msgid "`myst_words_per_minute`" +msgstr "" + +#: ../../../docs/configuration.md:78 ../../../docs/configuration.md:122 +msgid "For reading speed calculations (default: `200`)" +msgstr "" + +#: ../../../docs/configuration.md:25 ../../../docs/configuration.md:138 +msgid "Extensions" +msgstr "" + +#: ../../../docs/configuration.md:27 ../../../docs/configuration.md:140 +msgid "Configuration specific to syntax extensions:" +msgstr "" + +#: ../../../docs/configuration.md:37 +msgid "`myst_substitutions`" +msgstr "" + +#: ../../../docs/configuration.md:38 ../../../docs/configuration.md:151 +msgid "`dict[str, Any]`" +msgstr "" + +#: ../../../docs/configuration.md:39 ../../../docs/configuration.md:152 +msgid "substitutions: Substitutions mapping (default: `{}`)" +msgstr "" + +#: ../../../docs/configuration.md:40 +msgid "`myst_sub_delimiters`" +msgstr "" + +#: ../../../docs/configuration.md:41 ../../../docs/configuration.md:154 +msgid "`tuple[str, str]`" +msgstr "" + +#: ../../../docs/configuration.md:42 ../../../docs/configuration.md:155 +msgid "substitutions: Substitution delimiters (default: `('{', '}')`)" +msgstr "" + +#: ../../../docs/configuration.md:43 +msgid "`myst_linkify_fuzzy_links`" +msgstr "" + +#: ../../../docs/configuration.md:45 ../../../docs/configuration.md:158 +msgid "linkify: Recognise URLs without schema prefixes (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:46 +msgid "`myst_dmath_allow_labels`" +msgstr "" + +#: ../../../docs/configuration.md:48 ../../../docs/configuration.md:161 +msgid "dollarmath: Parse `$$...$$ (label)` (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:49 +msgid "`myst_dmath_allow_space`" +msgstr "" + +#: ../../../docs/configuration.md:51 ../../../docs/configuration.md:164 +msgid "dollarmath: Allow initial/final spaces in `$ ... $` (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:52 +msgid "`myst_dmath_allow_digits`" +msgstr "" + +#: ../../../docs/configuration.md:54 ../../../docs/configuration.md:167 +msgid "dollarmath: Allow initial/final digits `1$ ...$2` (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:55 +msgid "`myst_dmath_double_inline`" +msgstr "" + +#: ../../../docs/configuration.md:57 ../../../docs/configuration.md:170 +msgid "dollarmath: Parse inline `$$ ... $$` (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:58 +msgid "`myst_update_mathjax`" +msgstr "" + +#: ../../../docs/configuration.md:60 +msgid "" +"dollarmath: Update sphinx.ext.mathjax configuration to ignore `$` " +"delimiters (default: `True`)" +msgstr "" + +#: ../../../docs/configuration.md:61 +msgid "`myst_mathjax_classes`" +msgstr "" + +#: ../../../docs/configuration.md:62 +msgid "`str`" +msgstr "" + +#: ../../../docs/configuration.md:63 +msgid "" +"dollarmath: MathJax classes to add to math HTML (default: " +"`'tex2jax_process|mathjax_process|math|output_area'`)" +msgstr "" + +#: ../../../docs/configuration.md:64 +msgid "`myst_enable_checkboxes`" +msgstr "" + +#: ../../../docs/configuration.md:66 ../../../docs/configuration.md:173 +msgid "tasklist: Enable checkboxes (default: `False`)" +msgstr "" + +#: ../../../docs/configuration.md:37 +msgid "Frontmatter (local) configuration" +msgstr "" + +#: ../../../docs/configuration.md:39 +msgid "" +"Frontmatter allows you to specify metadata and options about how a single" +" document should behave or render. It is a " +"[YAML](https://en.wikipedia.org/wiki/YAML) block at the start of the " +"document, as used for example in [jekyll](https://jekyllrb.com/docs" +"/front-matter/). The document should start with three or more `---` " +"markers, and YAML is parsed until a closing `---` marker is found:" +msgstr "" + +#: ../../../docs/configuration.md:53 +msgid "" +"Frontmatter is also used for the [substitution syntax " +"extension](syntax/substitutions), and can be used to store information " +"for blog posting (see [ablog's myst-parser " +"support](https://ablog.readthedocs.io/en/latest/manual/markdown.html))." +msgstr "" + +#: ../../../docs/configuration.md:57 +msgid "" +"The following configuration variables are available to be set in the " +"document frontmatter. These can be set in the document [front " +"matter](syntax/frontmatter), under the `myst` key, e.g." +msgstr "" + +#: ../../../docs/configuration.md:75 +msgid "`commonmark_only`" +msgstr "" + +#: ../../../docs/configuration.md:78 +msgid "`gfm_only`" +msgstr "" + +#: ../../../docs/configuration.md:81 +msgid "`enable_extensions`" +msgstr "" + +#: ../../../docs/configuration.md:84 +msgid "`disable_syntax`" +msgstr "" + +#: ../../../docs/configuration.md:87 +msgid "`all_links_external`" +msgstr "" + +#: ../../../docs/configuration.md:90 +msgid "`links_external_new_tab`" +msgstr "" + +#: ../../../docs/configuration.md:93 +msgid "`url_schemes`" +msgstr "" + +#: ../../../docs/configuration.md:96 +msgid "`ref_domains`" +msgstr "" + +#: ../../../docs/configuration.md:99 +msgid "`fence_as_directive`" +msgstr "" + +#: ../../../docs/configuration.md:102 +msgid "`number_code_blocks`" +msgstr "" + +#: ../../../docs/configuration.md:105 +msgid "`title_to_header`" +msgstr "" + +#: ../../../docs/configuration.md:108 +msgid "`heading_anchors`" +msgstr "" + +#: ../../../docs/configuration.md:111 +msgid "`html_meta`" +msgstr "" + +#: ../../../docs/configuration.md:114 +msgid "`footnote_sort`" +msgstr "" + +#: ../../../docs/configuration.md:117 +msgid "`footnote_transition`" +msgstr "" + +#: ../../../docs/configuration.md:120 +msgid "`words_per_minute`" +msgstr "" + +#: ../../../docs/configuration.md:74 +msgid "Setting HTML Metadata" +msgstr "" + +#: ../../../docs/configuration.md:76 +msgid "" +"The front-matter can contain the special key `html_meta`; a dict with " +"data to add to the generated HTML as [`` " +"elements](https://developer.mozilla.org/en-" +"US/docs/Web/HTML/Element/meta). This is equivalent to using the [meta " +"directive](inv:sphinx#html-meta)." +msgstr "" + +#: ../../../docs/configuration.md:79 +msgid "" +"HTML metadata can also be added globally in the `conf.py` *via* the " +"`myst_html_meta` variable, in which case it will be added to all MyST " +"documents. For each document, the `myst_html_meta` dict will be updated " +"by the document level front-matter `html_meta`, with the front-matter " +"taking precedence." +msgstr "" + +#: ../../../docs/configuration.md +msgid "Sphinx Configuration" +msgstr "" + +#: ../../../docs/configuration.md +msgid "MyST Front-Matter" +msgstr "" + +#: ../../../docs/configuration.md +msgid "RestructuredText" +msgstr "" + +#: ../../../docs/configuration.md +msgid "HTML Output" +msgstr "" + +#: ../../../docs/configuration.md:150 +msgid "`substitutions`" +msgstr "" + +#: ../../../docs/configuration.md:153 +msgid "`sub_delimiters`" +msgstr "" + +#: ../../../docs/configuration.md:156 +msgid "`linkify_fuzzy_links`" +msgstr "" + +#: ../../../docs/configuration.md:159 +msgid "`dmath_allow_labels`" +msgstr "" + +#: ../../../docs/configuration.md:162 +msgid "`dmath_allow_space`" +msgstr "" + +#: ../../../docs/configuration.md:165 +msgid "`dmath_allow_digits`" +msgstr "" + +#: ../../../docs/configuration.md:168 +msgid "`dmath_double_inline`" +msgstr "" + +#: ../../../docs/configuration.md:171 +msgid "`enable_checkboxes`" +msgstr "" + +#: ../../../docs/configuration.md:148 +msgid "List of syntax extensions" +msgstr "" + +#: ../../../docs/configuration.md:150 +msgid "Full details in the [](syntax/extensions) section." +msgstr "" + +#: ../../../docs/configuration.md:152 +msgid "amsmath" +msgstr "" + +#: ../../../docs/configuration.md:153 +msgid "" +"enable direct parsing of [amsmath](https://ctan.org/pkg/amsmath) LaTeX " +"equations" +msgstr "" + +#: ../../../docs/configuration.md:155 +msgid "attrs_inline" +msgstr "" + +#: ../../../docs/configuration.md:156 +msgid "Enable inline attribute parsing, [see here](syntax/attributes) for details" +msgstr "" + +#: ../../../docs/configuration.md:158 +msgid "colon_fence" +msgstr "" + +#: ../../../docs/configuration.md:159 +msgid "" +"Enable code fences using `:::` delimiters, [see here](syntax/colon_fence)" +" for details" +msgstr "" + +#: ../../../docs/configuration.md:161 +msgid "deflist" +msgstr "" + +#: ../../../docs/configuration.md:162 +msgid "Enable definition lists, [see here](syntax/definition-lists) for details" +msgstr "" + +#: ../../../docs/configuration.md:164 +msgid "dollarmath" +msgstr "" + +#: ../../../docs/configuration.md:165 +msgid "Enable parsing of dollar `$` and `$$` encapsulated math" +msgstr "" + +#: ../../../docs/configuration.md:167 +msgid "fieldlist" +msgstr "" + +#: ../../../docs/configuration.md:168 +msgid "Enable field lists, [see here](syntax/fieldlists) for details" +msgstr "" + +#: ../../../docs/configuration.md:170 +msgid "html_admonition" +msgstr "" + +#: ../../../docs/configuration.md:171 +msgid "" +"Convert `

` elements to sphinx admonition nodes," +" see the [HTML admonition syntax](syntax/html-admonition) for details" +msgstr "" + +#: ../../../docs/configuration.md:173 +msgid "html_image" +msgstr "" + +#: ../../../docs/configuration.md:174 +msgid "" +"Convert HTML `` elements to sphinx image nodes, [see " +"here](syntax/images) for details" +msgstr "" + +#: ../../../docs/configuration.md:176 +msgid "linkify" +msgstr "" + +#: ../../../docs/configuration.md:177 +msgid "Automatically identify \"bare\" web URLs and add hyperlinks" +msgstr "" + +#: ../../../docs/configuration.md:179 +msgid "replacements" +msgstr "" + +#: ../../../docs/configuration.md:180 +msgid "Automatically convert some common typographic texts" +msgstr "" + +#: ../../../docs/configuration.md:182 +msgid "smartquotes" +msgstr "" + +#: ../../../docs/configuration.md:183 +msgid "" +"Automatically convert standard quotations to their opening/closing " +"variants" +msgstr "" + +#: ../../../docs/configuration.md:185 +msgid "strikethrough" +msgstr "" + +#: ../../../docs/configuration.md:186 +msgid "Enable strikethrough syntax, [see here](syntax/strikethrough) for details" +msgstr "" + +#: ../../../docs/configuration.md:188 +msgid "substitution" +msgstr "" + +#: ../../../docs/configuration.md:189 +msgid "Substitute keys, [see here](syntax/substitutions) for details" +msgstr "" + +#: ../../../docs/configuration.md:191 +msgid "tasklist" +msgstr "" + +#: ../../../docs/configuration.md:192 +msgid "" +"Add check-boxes to the start of list items, [see here](syntax/tasklists) " +"for details" +msgstr "" + +#: ../../../docs/configuration.md:196 +msgid "Build Warnings" +msgstr "" + +#: ../../../docs/configuration.md:198 +msgid "" +"Below lists the MyST specific warnings that may be emitted during the " +"build process. These will be prepended to the end of the warning message " +"(see also ), e.g." +msgstr "" + +#: ../../../docs/configuration.md:204 +msgid "" +"In general, if your build logs any warnings, you should either fix them " +"or [raise an Issue](https://github.com/executablebooks/MyST-" +"Parser/issues/new/choose) if you think the warning is erroneous." +msgstr "" + +#: ../../../docs/configuration.md:206 +msgid "" +"However, in some circumstances if you wish to suppress the warning you " +"can use the configuration option, e.g." +msgstr "" + +#: ../../../docs/configuration.md:212 +msgid "" +"Or use `--myst-suppress-warnings=\"myst.header\"` for the [docutils CLI" +"](myst-docutils)." +msgstr "" + +#: ../../../docs/configuration.md:215 +msgid "`myst.deprecated`: Deprecated usage." +msgstr "" + +#: ../../../docs/configuration.md:216 +msgid "`myst.not_supported`: Functionality that is not yet supported in docutils." +msgstr "" + +#: ../../../docs/configuration.md:217 +msgid "`myst.render`: The render method is not implemented." +msgstr "" + +#: ../../../docs/configuration.md:218 +msgid "`myst.topmatter`: Issue reading front-matter." +msgstr "" + +#: ../../../docs/configuration.md:219 +msgid "`myst.duplicate_def`: Duplicate Markdown reference definition." +msgstr "" + +#: ../../../docs/configuration.md:220 +msgid "`myst.header`: Non-consecutive heading levels." +msgstr "" + +#: ../../../docs/configuration.md:221 +msgid "`myst.directive_parse`: Issue parsing directive." +msgstr "" + +#: ../../../docs/configuration.md:222 +msgid "`myst.directive_option`: Issue parsing directive options." +msgstr "" + +#: ../../../docs/configuration.md:223 +msgid "" +"`myst.directive_comments`: Directive options has # comments, which may " +"not be supported in future versions." +msgstr "" + +#: ../../../docs/configuration.md:224 +msgid "`myst.directive_body`: Issue parsing directive body." +msgstr "" + +#: ../../../docs/configuration.md:225 +msgid "`myst.directive_unknown`: Unknown directive." +msgstr "" + +#: ../../../docs/configuration.md:226 +msgid "`myst.role_unknown`: Unknown role." +msgstr "" + +#: ../../../docs/configuration.md:227 +msgid "`myst.xref_ambiguous`: Multiple targets were found for a cross-reference." +msgstr "" + +#: ../../../docs/configuration.md:228 +msgid "`myst.xref_missing`: A target was not found for a cross-reference." +msgstr "" + +#: ../../../docs/configuration.md:229 +msgid "`myst.inv_retrieval`: Failure to retrieve or load an inventory." +msgstr "" + +#: ../../../docs/configuration.md:230 +msgid "`myst.iref_missing`: A target was not found for an inventory reference." +msgstr "" + +#: ../../../docs/configuration.md:231 +msgid "" +"`myst.iref_ambiguous`: Multiple targets were found for an inventory " +"reference." +msgstr "" + +#: ../../../docs/configuration.md:232 +msgid "" +"`myst.domains`: A legacy domain found, which does not support " +"`resolve_any_xref`." +msgstr "" + +#: ../../../docs/configuration.md:233 +msgid "`myst.heading_slug`: An error occurred computing a heading slug." +msgstr "" + +#: ../../../docs/configuration.md:234 +msgid "" +"`myst.strikethrough`: Strikethrough warning, since only implemented in " +"HTML." +msgstr "" + +#: ../../../docs/configuration.md:235 +msgid "`myst.html`: HTML could not be parsed." +msgstr "" + +#: ../../../docs/configuration.md:236 +msgid "`myst.attribute`: Invalid attribute value." +msgstr "" + +#: ../../../docs/configuration.md:237 +msgid "`myst.substitution`: Substitution could not be resolved." +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/develop.po b/locales/zh_CN/LC_MESSAGES/develop.po new file mode 100644 index 00000000..dfbc0c75 --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/develop.po @@ -0,0 +1,2579 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../CHANGELOG.md:2 +msgid "Changelog" +msgstr "" + +#: ../../../CHANGELOG.md:4 +msgid "4.0.0 - 2024-08-05" +msgstr "" + +#: ../../../CHANGELOG.md:6 +msgid "This release bumps the supported versions of:" +msgstr "" + +#: ../../../CHANGELOG.md:8 +msgid "Python to ``3.10`` and greater" +msgstr "" + +#: ../../../CHANGELOG.md:9 +msgid "Sphinx to ``>=7,<9``" +msgstr "" + +#: ../../../CHANGELOG.md:10 +msgid "Docutils to ``>=0.19,<0.22``" +msgstr "" + +#: ../../../CHANGELOG.md:12 +msgid "" +"Additionally, footnotes are now parsed similar to the corresponding " +"reStructuredText, in that resolution (between definitions and references)" +" and ordering is now deferred to transforms on the doctree (in )." +msgstr "" + +#: ../../../CHANGELOG.md:14 +msgid "" +"This allows for the proper interaction with other docutils/sphinx " +"transforms, including those that perform translations, and logging of " +"warnings for duplicate/unreferenced footnote definitions and also for " +"footnote references with no definitions." +msgstr "" + +#: ../../../CHANGELOG.md:17 +msgid "See the [footnotes guide](#syntax/footnotes) for more information." +msgstr "" + +#: ../../../CHANGELOG.md:19 +msgid "" +"**Full Changelog**: [v3.0.1...v4.0.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v3.0.1...v4.0.0)" +msgstr "" + +#: ../../../CHANGELOG.md:21 +msgid "3.0.1 - 2024-04-28" +msgstr "" + +#: ../../../CHANGELOG.md:23 +msgid "🐛 Bug Fixes" +msgstr "" + +#: ../../../CHANGELOG.md:25 +msgid "" +"Account for the final directive option having an empty value, by in " +msgstr "" + +#: ../../../CHANGELOG.md:26 +msgid "" +"Re-allow indented directive option blocks, by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:28 +msgid "" +"**Full Changelog**: [v3.0.0...v3.0.1](https://github.com/executablebooks" +"/MyST-Parser/compare/v3.0.0...v3.0.1)" +msgstr "" + +#: ../../../CHANGELOG.md:30 +msgid "3.0.0 - 2024-04-23" +msgstr "" + +#: ../../../CHANGELOG.md:32 +msgid "Upgraded dependencies" +msgstr "" + +#: ../../../CHANGELOG.md:34 +msgid "⬆️ Add support for Python 3.12 by in " +msgstr "" + +#: ../../../CHANGELOG.md:35 +msgid "" +"⬆️ Update docutils requirement from >=0.16,<0.21 to >=0.18,<0.22 by in " +msgstr "" + +#: ../../../CHANGELOG.md:37 +msgid "New features" +msgstr "" + +#: ../../../CHANGELOG.md:39 +msgid "" +"✨ Allow for use of the `line-block` directive by " +"in " +msgstr "" + +#: ../../../CHANGELOG.md:40 +msgid "✨ Emits sphinx include-read event by in " +msgstr "" + +#: ../../../CHANGELOG.md:42 +msgid "Improvements" +msgstr "" + +#: ../../../CHANGELOG.md:44 +msgid "" +"👌 Nested parse attribution in `attr_block` by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:45 +msgid "👌 Directive option parsing by in in " +msgstr "" + +#: ../../../CHANGELOG.md:47 +msgid "" +"👌 Allow for opening external links in new tabs (#856) by in " +msgstr "" + +#: ../../../CHANGELOG.md:49 +msgid "Internal" +msgstr "" + +#: ../../../CHANGELOG.md:51 +msgid "" +"🔧 Replace black, isort, pyupgrade with ruff formatter by in " +msgstr "" + +#: ../../../CHANGELOG.md:52 +msgid "🔧 remove redundant mypy config by in " +msgstr "" + +#: ../../../CHANGELOG.md:53 +msgid "" +"🔧 Add additional Ruff lints (and fix issues) by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:54 +msgid "🔧 mypy- disallow 'any generics' by in " +msgstr "" + +#: ../../../CHANGELOG.md:55 +msgid "" +"🔧 Fix docutils deprecation in option parsing by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:57 +msgid "Documentation" +msgstr "" + +#: ../../../CHANGELOG.md:59 +msgid "📚 Fix a broken link in configuration.md by in " +msgstr "" + +#: ../../../CHANGELOG.md:60 +msgid "" +"📚 Add linkify dependency to contributing docs. by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:61 +msgid "" +"📚 Fix the double `used` in docs/syntax/math.md by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:62 +msgid "" +"📚 Also add linkify to pip install command in README by in " +msgstr "" + +#: ../../../CHANGELOG.md:63 +msgid "" +"📚 Fix the code section title in live preview by in " +msgstr "" + +#: ../../../CHANGELOG.md:64 +msgid "📚 Fix admonition example by in " +msgstr "" + +#: ../../../CHANGELOG.md:65 +msgid "" +"📚 Fix url for jupyter book gallery by in " +msgstr "" + +#: ../../../CHANGELOG.md:66 +msgid "📚 Update theme version by in " +msgstr "" + +#: ../../../CHANGELOG.md:67 +msgid "📚 Fix typo by in " +msgstr "" + +#: ../../../CHANGELOG.md:68 +msgid "📚 Fix architecture typo (#855) by in " +msgstr "" + +#: ../../../CHANGELOG.md:70 +msgid "" +"**Full Changelog**: [v2.0.0...v3.0.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v2.0.0...v3.0.0)" +msgstr "" + +#: ../../../CHANGELOG.md:72 +msgid "2.0.0 - 2023-06-13" +msgstr "" + +#: ../../../CHANGELOG.md:74 +msgid "" +"This release primarily updates core myst-parser dependencies, with some " +"minor changes to parsing behaviour:" +msgstr "" + +#: ../../../CHANGELOG.md:77 +msgid "⬆️ UPGRADE: `markdown-it-py` to v3 ()" +msgstr "" + +#: ../../../CHANGELOG.md:78 +msgid "This is mainly a non-breaking change, fixing some edge cases in parsing" +msgstr "" + +#: ../../../CHANGELOG.md:79 +msgid "" +"See: and " +msgstr "" + +#: ../../../CHANGELOG.md:82 +msgid "⬆️ UPGRADE: `linkify-it-py` to v2 ()" +msgstr "" + +#: ../../../CHANGELOG.md:83 +msgid "Also fixes some edge cases in parsing" +msgstr "" + +#: ../../../CHANGELOG.md:84 +msgid "See: " +msgstr "" + +#: ../../../CHANGELOG.md:86 +msgid "⬆️ UPGRADE: Add support for `docutils` v0.20 ()" +msgstr "" + +#: ../../../CHANGELOG.md:87 +msgid "" +"No significant changes, see " +msgstr "" + +#: ../../../CHANGELOG.md:89 +msgid "" +"⬆️ UPGRADE: Add support for `sphinx` v7, and remove v5 support ()" +msgstr "" + +#: ../../../CHANGELOG.md:90 +msgid "" +"No significant changes, see " +msgstr "" + +#: ../../../CHANGELOG.md:92 +msgid "" +"⬆️ UPGRADE: Remove Python 3.7 support and add testing for Python 3.11 " +"()" +msgstr "" + +#: ../../../CHANGELOG.md:94 +msgid "" +"👌 Improve default slug generation for heading anchors, thanks to ()" +msgstr "" + +#: ../../../CHANGELOG.md:95 +msgid "" +"This change makes the slug generation closer to GitHub, in that, " +"starting/ending whitespace will not be stripped. For example, ``# ` a` b " +"`c ` `` will now correctly create the slug `-a-b-c-` and not `a-b-c`" +msgstr "" + +#: ../../../CHANGELOG.md:98 +msgid "👌 IMPROVE: Substitution extension ()" +msgstr "" + +#: ../../../CHANGELOG.md:99 +msgid "" +"Allow any value type (including dict, list, datetime) and emit a " +"`myst.substitution` warning for errors in resolving the substitution " +"content." +msgstr "" + +#: ../../../CHANGELOG.md:101 +msgid "" +"🧪 Introduce a gate/check GHA job, thanks to ()" +msgstr "" + +#: ../../../CHANGELOG.md:103 +msgid "" +"**Full Changelog**: [v1.0.0...v2.0.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v1.0.0...v2.0.0)" +msgstr "" + +#: ../../../CHANGELOG.md:105 +msgid "1.0.0 - 2023-03-07" +msgstr "" + +#: ../../../CHANGELOG.md:107 +msgid "🎉 **MyST-Parser 1.0.0** 🎉" +msgstr "" + +#: ../../../CHANGELOG.md:109 +msgid "" +"This changes absolutely nothing in the code, or about the " +"maintenance/release policy of this project. But it does feel about time 😄" +msgstr "" + +#: ../../../CHANGELOG.md:112 +msgid "0.19.2 - 2023-03-02" +msgstr "" + +#: ../../../CHANGELOG.md:114 +msgid "✨ NEW: Add myst_fence_as_directive config ()" +msgstr "" + +#: ../../../CHANGELOG.md:116 +msgid "Setting the following config, for example:" +msgstr "" + +#: ../../../CHANGELOG.md:125 +msgid "allows for one to write:" +msgstr "" + +#: ../../../CHANGELOG.md:136 +msgid "and have interoperable rendering with tools like GitHub." +msgstr "" + +#: ../../../CHANGELOG.md:138 +msgid "🎉 New contributors:" +msgstr "" + +#: ../../../CHANGELOG.md:140 +msgid "" +"📚 Add `html_last_updated_fmt = \"\"` to conf.py to fix documentation " +"footer, thanks to ()" +msgstr "" + +#: ../../../CHANGELOG.md:141 +msgid "📚 Fix the sphinx-design example, thanks to ()" +msgstr "" + +#: ../../../CHANGELOG.md:143 +msgid "0.19.1 - 2023-03-07" +msgstr "" + +#: ../../../CHANGELOG.md:145 +msgid "" +"🐛 FIX `NoURI` error in doc reference resolution, for texinfo builds ()" +msgstr "" + +#: ../../../CHANGELOG.md:147 +msgid "0.19.0 - 2023-03-01" +msgstr "" + +#: ../../../CHANGELOG.md:149 +msgid "" +"This release brings a number of exciting new features, improvements, and " +"upgrades 🎉" +msgstr "" + +#: ../../../CHANGELOG.md:151 +msgid "" +"Full Changelog: [v0.18.1...v0.19.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.18.1...v0.19.0)" +msgstr "" + +#: ../../../CHANGELOG.md:153 +msgid "📚 Rewritten documentation" +msgstr "" + +#: ../../../CHANGELOG.md:155 +msgid "" +"The documentation has been almost completely rewritten, with a clearer " +"structure, many more examples, rich hover tips, and a new live preview " +"page (powered by [pyscript](https://pyscript.readthedocs.io/), )." +msgstr "" + +#: ../../../CHANGELOG.md:158 +msgid "" +"The code base API is also now fully documented by [sphinx-autodoc2](https" +"://sphinx-autodoc2.readthedocs.io/), which even allows for MyST " +"docstrings! ()." +msgstr "" + +#: ../../../CHANGELOG.md:160 +msgid "⬆️ Add Sphinx 6 support, drop Sphinx 4" +msgstr "" + +#: ../../../CHANGELOG.md:162 +msgid "" +"The code base has been updated to support sphinx v6, and is no longer " +"tested against sphinx v4 ()" +msgstr "" + +#: ../../../CHANGELOG.md:164 +msgid "📄 Extended docutils (single-page) support" +msgstr "" + +#: ../../../CHANGELOG.md:166 +msgid "" +"The `docutils` parser now supports many more features, and improvements " +"to support live previews:" +msgstr "" + +#: ../../../CHANGELOG.md:168 +msgid "" +"`myst_suppress_warnings` option added, mirroring Sphinx, to suppress MyST" +" warnings ()" +msgstr "" + +#: ../../../CHANGELOG.md:169 +msgid "" +"`myst_meta_html` and `myst_substitutions` options are now supported ()" +msgstr "" + +#: ../../../CHANGELOG.md:170 +msgid "`myst_heading_anchors` option is now supported ()" +msgstr "" + +#: ../../../CHANGELOG.md:171 +msgid "Math block labels syntax is now supported ()" +msgstr "" + +#: ../../../CHANGELOG.md:172 +msgid "" +"Missing directive/role errors errors are now suppressible warnings ()" +msgstr "" + +#: ../../../CHANGELOG.md:173 +msgid "" +"Non-fatal directive parsing errors are now suppressible warnings ()" +msgstr "" + +#: ../../../CHANGELOG.md:174 +msgid "Most of the extended markdown syntax below is also supported" +msgstr "" + +#: ../../../CHANGELOG.md:176 +msgid "🔗 Extended Markdown links" +msgstr "" + +#: ../../../CHANGELOG.md:178 +msgid "" +"See the [Extended Markdown links](docs/syntax/cross-referencing.md) " +"section for the full guide." +msgstr "" + +#: ../../../CHANGELOG.md:180 +msgid "" +"You can now use standard Markdown link syntax to reference many different" +" types of targets, in a more consistent way." +msgstr "" + +#: ../../../CHANGELOG.md:182 +msgid "" +"`[text](relative/path/myfile.md)` work as previously, to link to files, " +"but they can also be relative to source directory: " +"`[text](/path/from/srcdir/myfile.md)`. You can also use " +"``" +msgstr "" + +#: ../../../CHANGELOG.md:185 +msgid "`` will link specifically to a downloadable file" +msgstr "" + +#: ../../../CHANGELOG.md:186 +msgid "" +"`[text](#target)` or `` will link (in order of priority)" +" to any local target, local heading anchor, target in the same project, " +"or intersphinx (inventory) target" +msgstr "" + +#: ../../../CHANGELOG.md:187 +msgid "" +"`[text](inv:name:domain:type#target)` will link specifically to a Sphinx " +"inventory target, or to any inventory ``, and can even use " +"`*` wildcards like ``" +msgstr "" + +#: ../../../CHANGELOG.md:188 +msgid "" +"This can even be used in docutils, with the new `myst_inventories` config" +" option" +msgstr "" + +#: ../../../CHANGELOG.md:189 +msgid "The `myst-inv` CLI makes it easy to find the correct inventory target" +msgstr "" + +#: ../../../CHANGELOG.md:192 +msgid "" +"It is advised (although not immediately necessary) to prefix all internal" +" references with `#`. For example, `[...](my-reference)`, should be " +"changed to `[...](#my-reference)`." +msgstr "" + +#: ../../../CHANGELOG.md:196 +msgid "`{}` Attributes syntax" +msgstr "" + +#: ../../../CHANGELOG.md:198 +msgid "" +"The [`attrs_inline` and " +"`attrs_block`](docs/syntax/optional.md#attributes) extensions allow for " +"common Markdown syntaxes to be extended with greater control over the " +"output." +msgstr "" + +#: ../../../CHANGELOG.md:200 +msgid "" +"For example, you can now add classes, ids, and other attributes to inline" +" code, images, and links, as well as to code blocks and directives." +msgstr "" + +#: ../../../CHANGELOG.md:202 +msgid "Inline code: `` `a = 1`{#id .class l=python} ``" +msgstr "" + +#: ../../../CHANGELOG.md:203 +msgid "Images: `![image](image.png){#id .class width=100px}`" +msgstr "" + +#: ../../../CHANGELOG.md:204 +msgid "Text spans: `[some text]{#id .class}`" +msgstr "" + +#: ../../../CHANGELOG.md:206 +msgid "A paragraph block can have attributes too:" +msgstr "" + +#: ../../../CHANGELOG.md:213 +msgid "A code fence can be given line numbers and line emphasis:" +msgstr "" + +#: ../../../CHANGELOG.md:224 +msgid "A definition list can be turned into a glossary, with referenceable terms:" +msgstr "" + +#: ../../../CHANGELOG.md:232 +msgid "Quote blocks can be given an attribution:" +msgstr "" + +#: ../../../CHANGELOG.md:239 +msgid "👌 Miscellaneous improvements" +msgstr "" + +#: ../../../CHANGELOG.md:241 +msgid "" +"Nested headings (e.g. inside directives) are now allowed in MyST and are " +"correctly rendered in HTML ()" +msgstr "" + +#: ../../../CHANGELOG.md:242 +msgid "" +"The `colon_fence` extension now renders internal content as MyST, rather " +"than as a code block ()" +msgstr "" + +#: ../../../CHANGELOG.md:243 +msgid "" +"The `include` directive in MyST documents now supports a `:heading-" +"offset:` option, to offset the heading levels in the included document" +msgstr "" + +#: ../../../CHANGELOG.md:244 +msgid "" +"The `myst_heading_slug_func` option now supports setting a `str` which " +"points to a fully qualified function name, e.g. `\"module.path.func\"` " +"()" +msgstr "" + +#: ../../../CHANGELOG.md:245 +msgid "" +"The `myst_enable_checkboxes` option allows for task list checkboxes to be" +" enabled/disabled ()" +msgstr "" + +#: ../../../CHANGELOG.md:247 +msgid "Additional contributions" +msgstr "" + +#: ../../../CHANGELOG.md:249 +msgid "" +"🐛 FIX: Remove unnecessary assert in , thanks to " +msgstr "" + +#: ../../../CHANGELOG.md:250 +msgid "🔧 ci(deps): setup dependabot (), thanks to " +msgstr "" + +#: ../../../CHANGELOG.md:251 +msgid "" +"🔧: Depend on typing_extensions only on `Python<3.8` in , " +"thanks to " +msgstr "" + +#: ../../../CHANGELOG.md:253 +msgid "0.18.1 - 2022-27-09" +msgstr "" + +#: ../../../CHANGELOG.md:255 +msgid "" +"Full Changelog: [v0.18.0...v0.18.1](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.18.0...v0.18.1)" +msgstr "" + +#: ../../../CHANGELOG.md:257 +msgid "⬆️ UPGRADE: docutils 0.19 support in " +msgstr "" + +#: ../../../CHANGELOG.md:258 +msgid "✨ NEW: Add `attrs_image` (experimental) extension in " +msgstr "" + +#: ../../../CHANGELOG.md:259 +msgid "e.g. `![image](image.png){#id .class width=100px}`" +msgstr "" + +#: ../../../CHANGELOG.md:260 +msgid "See: [Optional syntax section](docs/syntax/optional.md)" +msgstr "" + +#: ../../../CHANGELOG.md:261 +msgid "" +"**Important**: This is an experimental extension, and may change in " +"future releases" +msgstr "" + +#: ../../../CHANGELOG.md:263 +msgid "0.18.0 - 2022-06-07" +msgstr "" + +#: ../../../CHANGELOG.md:265 +msgid "" +"Full Changelog: [v0.17.2...v0.18.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.17.2...v0.18.0)" +msgstr "" + +#: ../../../CHANGELOG.md:267 +msgid "" +"This release adds support for Sphinx v5 (dropping v3), restructures the " +"code base into modules, and also restructures the documentation, to make " +"it easier for developers/users to follow." +msgstr "" + +#: ../../../CHANGELOG.md:269 +msgid "" +"It also introduces **document-level configuration** *via* the Markdown " +"front-matter, under the `myst` key. See the [Local " +"configuration](docs/configuration.md) section for more information." +msgstr "" + +#: ../../../CHANGELOG.md:272 +msgid "Breaking changes" +msgstr "" + +#: ../../../CHANGELOG.md:274 +msgid "" +"This should not be breaking, for general users of the sphinx extension " +"(with `sphinx>3`), but will be for anyone directly using the Python API, " +"mainly just requiring changes in import module paths." +msgstr "" + +#: ../../../CHANGELOG.md:277 +msgid "" +"The `to_docutils`, `to_html`, `to_tokens` (from `myst_parser/main.py`) " +"and `mock_sphinx_env`/`parse` (from `myst_parser.sphinx_renderer.py`) " +"functions have been removed, since these were primarily for internal " +"testing. Instead, for single page builds, users should use the docutils " +"parser API/CLI (see [](docs/docutils.md)), and for testing, functionality" +" has been moved to ." +msgstr "" + +#: ../../../CHANGELOG.md:281 +msgid "" +"The top-level `html_meta` and `substitutions` front-matter keys have also" +" been deprecated (i.e. they will still work but will emit a warning), as " +"they now form part of the `myst` config, e.g." +msgstr "" + +#: ../../../CHANGELOG.md:292 +msgid "is replaced by:" +msgstr "" + +#: ../../../CHANGELOG.md:304 +msgid "Key PRs" +msgstr "" + +#: ../../../CHANGELOG.md:306 +msgid "♻️📚 Restructure code base and documentation ()" +msgstr "" + +#: ../../../CHANGELOG.md:307 +msgid "⬆️ Drop Sphinx 3 and add Sphinx 5 support ()" +msgstr "" + +#: ../../../CHANGELOG.md:308 +msgid "🐛 FIX: `parse_directive_text` when body followed by options ()" +msgstr "" + +#: ../../../CHANGELOG.md:309 +msgid "" +"🐛 FIX: floor table column widths to integers (), thanks to " +"!" +msgstr "" + +#: ../../../CHANGELOG.md:311 +msgid "0.17.2 - 2022-04-17" +msgstr "" + +#: ../../../CHANGELOG.md:313 +msgid "" +"Full Changelog: [v0.17.1...v0.17.2](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.17.1...v0.17.2)" +msgstr "" + +#: ../../../CHANGELOG.md:315 +msgid "" +"♻️ REFACTOR: Replace `attrs` by `dataclasses` for configuration ()" +msgstr "" + +#: ../../../CHANGELOG.md:317 +msgid "0.17.1 - 2022-04-15" +msgstr "" + +#: ../../../CHANGELOG.md:319 +msgid "" +"Full Changelog: [v0.17.0...v0.17.1](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.17.0...v0.17.1)" +msgstr "" + +#: ../../../CHANGELOG.md:321 +msgid "🐛 FIX: Heading anchor resolution for parallel builds ()" +msgstr "" + +#: ../../../CHANGELOG.md:322 +msgid "🔧 MAINTAIN: Move packaging from setuptools to flit ()" +msgstr "" + +#: ../../../CHANGELOG.md:323 +msgid "🔧 MAINTAIN: Directly specify attrs dependency ()" +msgstr "" + +#: ../../../CHANGELOG.md:325 +msgid "0.17.0 - 2022-02-11" +msgstr "" + +#: ../../../CHANGELOG.md:327 +msgid "This release contains a number of breaking improvements." +msgstr "" + +#: ../../../CHANGELOG.md:329 +msgid "" +"Full Changelog: [v0.16.1...v0.17.0](https://github.com/executablebooks" +"/MyST-Parser/compare/v0.16.1...v0.17.0)" +msgstr "" + +#: ../../../CHANGELOG.md:331 +msgid "‼️ Markdown link resolution improvements" +msgstr "" + +#: ../../../CHANGELOG.md:333 +msgid "" +"**WARNING: This is a breaking change for links that rely on auto-" +"generated anchor links**. You should now [manually enable auto-generated " +"anchor links](https://myst-" +"parser.readthedocs.io/en/latest/syntax/optional.html?highlight=anchor" +"#auto-generated-header-anchors) if you see errors like `WARNING reference" +" target not found`." +msgstr "" + +#: ../../../CHANGELOG.md:335 +msgid "" +"Markdown links are of the format `[text](link)`. MyST-Parser looks to " +"smartly resolve such links, by identifying if they are:" +msgstr "" + +#: ../../../CHANGELOG.md:338 +msgid "A link to an external resource, e.g. `[text](http://example.com)`" +msgstr "" + +#: ../../../CHANGELOG.md:339 +msgid "A link to another source document, e.g. `[text](file.md)`" +msgstr "" + +#: ../../../CHANGELOG.md:340 +msgid "" +"If `header-anchors` are enabled, anchor links are also supported, e.g. " +"`[text](file.md#anchor)`" +msgstr "" + +#: ../../../CHANGELOG.md:341 +msgid "A link to an internal sphinx cross-reference, e.g. `[text](my-reference)`" +msgstr "" + +#: ../../../CHANGELOG.md:343 +msgid "an additional situation is now supported:" +msgstr "" + +#: ../../../CHANGELOG.md:345 +msgid "" +"A link to a source file, which is not a document, e.g. `[text](file.js)`." +" This behaves similarly to the sphinx `download` role." +msgstr "" + +#: ../../../CHANGELOG.md:347 +msgid "" +"In addition, configuration to more finely tune this behaviour has been " +"added." +msgstr "" + +#: ../../../CHANGELOG.md:349 +msgid "`myst_all_links_external=True`, will make all links be treated as (1)" +msgstr "" + +#: ../../../CHANGELOG.md:350 +msgid "" +"`myst_url_schemes=(\"http\", \"https\")`, sets what URL schemes are " +"treated as (1)" +msgstr "" + +#: ../../../CHANGELOG.md:351 +msgid "" +"`myst_ref_domains=(\"std\", \"py\")`, sets what Sphinx reference domains " +"are checked, when handling (3)" +msgstr "" + +#: ../../../CHANGELOG.md:353 +msgid "" +"See [Markdown Links and Referencing](docs/syntax/cross-referencing.md) " +"for more information." +msgstr "" + +#: ../../../CHANGELOG.md:355 +msgid "‼️ Dollarmath is now disabled by default" +msgstr "" + +#: ../../../CHANGELOG.md:357 +msgid "" +"**WARNING: This is a breaking change for dollar math**. You should now " +"manually enable dollar math (see below)." +msgstr "" + +#: ../../../CHANGELOG.md:359 +msgid "" +"The default configuration is now `myst_enable_extensions=()`, instead of " +"`myst_enable_extensions=(\"dollarmath\",)`. If you are using math " +"enclosed in `$` or `$$` in your documents, you should enable `dollarmath`" +" explicitly." +msgstr "" + +#: ../../../CHANGELOG.md:362 +msgid "" +"See [Dollar delimited math](docs/syntax/optional.md#math-shortcuts) for " +"more information." +msgstr "" + +#: ../../../CHANGELOG.md:364 +msgid "⬆️ Drop Python 3.6 support" +msgstr "" + +#: ../../../CHANGELOG.md:366 +msgid "MyST-Parser now supports, and is tested against, Python 3.7 to 3.10." +msgstr "" + +#: ../../../CHANGELOG.md:368 +msgid "✨ Add the `strikethrough` extension and `myst_gfm_only` configuration" +msgstr "" + +#: ../../../CHANGELOG.md:370 +msgid "" +"The `strikethrough` extension allows text within `~~` delimiters to have " +"a strike-through (horizontal line) placed over it. For example, " +"`~~strikethrough with *emphasis*~~` renders as: ~~strikethrough with " +"*emphasis*~~." +msgstr "" + +#: ../../../CHANGELOG.md:373 +msgid "**Important**: This extension is currently only supported for HTML output." +msgstr "" + +#: ../../../CHANGELOG.md:375 +msgid "" +"See [Strikethrough](docs/syntax/optional.md#strikethrough) for more " +"information." +msgstr "" + +#: ../../../CHANGELOG.md:377 +msgid "" +"The `myst_gfm_only=True` configuration sets up specific configuration, to" +" enable compliance only with [GitHub-flavored " +"Markdown](https://github.github.com/gfm/), including enabling the " +"`strikethrough`, `tasklist` and `linkify` extensions, but disabling " +"support for roles and directives." +msgstr "" + +#: ../../../CHANGELOG.md:379 +msgid "✨ Add `myst_title_to_header` configuration" +msgstr "" + +#: ../../../CHANGELOG.md:381 +msgid "" +"Setting `myst_title_to_header=True`, allows for a `title` key in the " +"frontmatter to be used as the document title. for example:" +msgstr "" + +#: ../../../CHANGELOG.md:390 +msgid "would be equivalent to:" +msgstr "" + +#: ../../../CHANGELOG.md:396 +msgid "See [Front matter](docs/configuration.md) for more information." +msgstr "" + +#: ../../../CHANGELOG.md:398 +msgid "👌 Internal improvements" +msgstr "" + +#: ../../../CHANGELOG.md:400 +msgid "" +"👌 IMPROVE: Convert nested headings to rubrics. Headings within directives" +" are not directly supported by sphinx, since they break the structure of " +"the document. Previously myst-parser would emit a `myst.nested_header` " +"warning, but still generate the heading, leading to unexpected outcomes. " +"Now the warning is still emitted, but also the heading is rendered as a " +"[rubric](https://docutils.sourceforge.io/docs/ref/rst/directives.html#rubric)" +" non-structural heading (i.e. it will not show in the ToC)." +msgstr "" + +#: ../../../CHANGELOG.md:404 +msgid "" +"Other internal improvements primarily focused in improving support for " +"the for \"docutils-only\" use, introduced in `v0.16`:" +msgstr "" + +#: ../../../CHANGELOG.md:406 +msgid "♻️ REFACTOR: `default_parser` -> `create_md_parser` in " +msgstr "" + +#: ../../../CHANGELOG.md:407 +msgid "👌 IMPROVE: Add `bullet` attribute to `bullet_list` node in " +msgstr "" + +#: ../../../CHANGELOG.md:408 +msgid "👌 IMPROVE: Use correct renderer for `state.inline_text` in " +msgstr "" + +#: ../../../CHANGELOG.md:409 +msgid "👌 IMPROVE: Docutils parser settings in " +msgstr "" + +#: ../../../CHANGELOG.md:410 +msgid "🐛 FIX: front-matter rendering with docutils in " +msgstr "" + +#: ../../../CHANGELOG.md:411 +msgid "👌 IMPROVE: Code block highlighting in " +msgstr "" + +#: ../../../CHANGELOG.md:412 +msgid "👌 IMPROVE: `note_refname` for docutils internal links in " +msgstr "" + +#: ../../../CHANGELOG.md:413 +msgid "🐛 FIX: Ordered list starting number in " +msgstr "" + +#: ../../../CHANGELOG.md:414 +msgid "👌 IMPROVE: Propagate enumerated list suffix in " +msgstr "" + +#: ../../../CHANGELOG.md:415 +msgid "👌 IMPROVE: `DocutilsRenderer.create_highlighted_code_block` in " +msgstr "" + +#: ../../../CHANGELOG.md:416 +msgid "🐛 FIX: Source line reporting for nested parsing in " +msgstr "" + +#: ../../../CHANGELOG.md:417 +msgid "🔧 MAINTAIN: Implement `MockInliner.parse` in " +msgstr "" + +#: ../../../CHANGELOG.md:419 +msgid "0.16.1 - 2021-12-16" +msgstr "" + +#: ../../../CHANGELOG.md:421 +msgid "" +"✨ NEW: Add `myst_linkify_fuzzy_links` option. When using the [`linkify` " +"extension](docs/syntax/optional.md#linkify), this option can be used to " +"disable matching of links that do not contain a schema (such as " +"`http://`)." +msgstr "" + +#: ../../../CHANGELOG.md:424 +msgid "0.16.0 - 2021-12-06" +msgstr "" + +#: ../../../CHANGELOG.md:426 +msgid "This release contains a number of exciting improvements:" +msgstr "" + +#: ../../../CHANGELOG.md:428 +msgid "Upgrade of Markdown parser" +msgstr "" + +#: ../../../CHANGELOG.md:430 +msgid "" +"`markdown-it-py` has been upgraded to " +"[v2.0.0](https://github.com/executablebooks/markdown-it-" +"py/releases/tag/v2.0.0). This upgrade brings full compliance with the " +"[CommonMark v0.30 specification](https://spec.commonmark.org/0.30/)." +msgstr "" + +#: ../../../CHANGELOG.md:433 +msgid "" +"Additionally, `mdit-py-plugins` has been upgraded to " +"[v0.3.0](https://github.com/executablebooks/mdit-py-" +"plugins/releases/tag/v0.3.0). This improves the parsing of the MyST " +"target syntax, to allow for spaces and additional special characters in " +"the target name, for example this is now valid:" +msgstr "" + +#: ../../../CHANGELOG.md:443 +msgid "" +"Also MyST role syntax now supports unlimited length in the role name and " +"new lines in the content. For example, this is now valid:" +msgstr "" + +#: ../../../CHANGELOG.md:451 +msgid "Improvements for Docutils-only use" +msgstr "" + +#: ../../../CHANGELOG.md:453 +msgid "" +"MyST now allows for Docutils-only use (outside of Sphinx), that allows " +"for MyST configuration options to be set via the `docutils.conf` file, or" +" on the command line." +msgstr "" + +#: ../../../CHANGELOG.md:455 +msgid "On installing MyST-Parser, the following CLI-commands are made available:" +msgstr "" + +#: ../../../CHANGELOG.md:457 +msgid "`myst-docutils-html`: converts MyST to HTML" +msgstr "" + +#: ../../../CHANGELOG.md:458 +msgid "`myst-docutils-html5`: converts MyST to HTML5" +msgstr "" + +#: ../../../CHANGELOG.md:459 +msgid "`myst-docutils-latex`: converts MyST to LaTeX" +msgstr "" + +#: ../../../CHANGELOG.md:460 +msgid "`myst-docutils-xml`: converts MyST to docutils-native XML" +msgstr "" + +#: ../../../CHANGELOG.md:461 +msgid "" +"`myst-docutils-pseudoxml`: converts MyST to pseudo-XML (to visualise the " +"AST structure)" +msgstr "" + +#: ../../../CHANGELOG.md:463 +msgid "" +"You can also install the [myst-docutils](https://pypi.org/project/myst-" +"docutils/) package from `pip`, which includes no direct install " +"requirements on docutils or sphinx." +msgstr "" + +#: ../../../CHANGELOG.md:466 +msgid "See [MyST with Docutils](docs/docutils.md) for more information." +msgstr "" + +#: ../../../CHANGELOG.md:468 +msgid "Thanks to help from !" +msgstr "" + +#: ../../../CHANGELOG.md:470 +msgid "Include MyST files in RST files" +msgstr "" + +#: ../../../CHANGELOG.md:472 +msgid "" +"With `docutils>=0.17`, the `include` directive has a `parser` option. " +"This can be used with myst-parser to include MyST files in RST files." +msgstr "" + +#: ../../../CHANGELOG.md:487 +msgid "Addition of the `fieldlist` syntax extension" +msgstr "" + +#: ../../../CHANGELOG.md:489 +msgid "" +"Field lists are mappings from field names to field bodies, based on the " +"[reStructureText " +"syntax](https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html" +"#field-lists):" +msgstr "" + +#: ../../../CHANGELOG.md:500 +msgid "" +"This should eventually allow for MyST Markdown docstrings! (see " +")" +msgstr "" + +#: ../../../CHANGELOG.md:502 +msgid "" +"See [Field Lists syntax](docs/syntax/optional.md#field-lists) for more " +"information." +msgstr "" + +#: ../../../CHANGELOG.md:504 +msgid "Improvements to table rendering" +msgstr "" + +#: ../../../CHANGELOG.md:506 +msgid "Tables with no body are now allowed, for example:" +msgstr "" + +#: ../../../CHANGELOG.md:513 +msgid "" +"Also cell alignment HTML classes have now been changed to: `text-left`, " +"`text-center`, or `text-right`, for example:" +msgstr "" + +#: ../../../CHANGELOG.md:521 +msgid "is converted to:" +msgstr "" + +#: ../../../CHANGELOG.md:542 +msgid "These classes should be supported by most sphinx HTML themes." +msgstr "" + +#: ../../../CHANGELOG.md:544 +msgid "See [Tables syntax](docs/syntax/tables.md) for more information." +msgstr "" + +#: ../../../CHANGELOG.md:546 +msgid "Pull Requests" +msgstr "" + +#: ../../../CHANGELOG.md:548 +msgid "" +"🐛 FIX: Add mandatory attributes on `enumerated_list` by in " +msgstr "" + +#: ../../../CHANGELOG.md:549 +msgid "" +"📚 DOCS: Add reference to MySTyc in landing page by " +"in " +msgstr "" + +#: ../../../CHANGELOG.md:550 +msgid "" +"⬆️ UPGRADE: markdown-it-py v2, mdit-py-plugins v0.3 by in " +msgstr "" + +#: ../../../CHANGELOG.md:551 +msgid "👌 IMPROVE: Table rendering by in " +msgstr "" + +#: ../../../CHANGELOG.md:552 +msgid "" +"🐛 FIX: Ensure parent files are re-built if `include` file changes by in " +msgstr "" + +#: ../../../CHANGELOG.md:553 +msgid "" +"🐛 FIX: Convert empty directive option to `None` by " +" in " +msgstr "" + +#: ../../../CHANGELOG.md:554 +msgid "" +"👌 IMPROVE: Add `\\\\` for hard-breaks in latex by " +"in " +msgstr "" + +#: ../../../CHANGELOG.md:555 +msgid "" +"🔧 MAINTAIN: Remove empty \"sphinx\" extra by in " +msgstr "" + +#: ../../../CHANGELOG.md:556 +msgid "✨ NEW: Add `fieldlist` extension by in " +msgstr "" + +#: ../../../CHANGELOG.md:557 +msgid "" +"✨ NEW: Add Docutils MyST config and CLI by in " +msgstr "" + +#: ../../../CHANGELOG.md:558 +msgid "" +"🔧 MAINTAIN: Add publishing job for `myst-docutils` by in " +msgstr "" + +#: ../../../CHANGELOG.md:559 +msgid "" +"🧪 TESTS: Add for `gettext_additional_targets` by in " +"" +msgstr "" + +#: ../../../CHANGELOG.md:561 +msgid "New Contributors" +msgstr "" + +#: ../../../CHANGELOG.md:563 +msgid " made their first contribution in " +msgstr "" + +#: ../../../CHANGELOG.md:564 +msgid " made their first contribution in " +msgstr "" + +#: ../../../CHANGELOG.md:566 +msgid "" +"**Full Changelog**: " +msgstr "" + +#: ../../../CHANGELOG.md:568 +msgid "0.15.2 - 2021-08-26" +msgstr "" + +#: ../../../CHANGELOG.md:570 +msgid "" +"This is mainly a maintenance release that fixes some incompatibilities " +"with `sphinx<3.1`, improvements for compatibility with `docutils=0.17`, " +"and improvements to robustness." +msgstr "" + +#: ../../../CHANGELOG.md:573 +msgid "0.15.1 - 2021-06-18" +msgstr "" + +#: ../../../CHANGELOG.md:575 +msgid "👌 IMPROVE: MathJax compatibility with `nbsphinx`" +msgstr "" + +#: ../../../CHANGELOG.md:577 +msgid "" +"`nbsphinx` also overrides the MathJax configuration. For compatibility, " +"`output_area` is added to the list of default processed classes, and the " +"override warning is allowed to be suppressed with `suppress_warnings = " +"[\"myst.mathjax\"]`." +msgstr "" + +#: ../../../CHANGELOG.md:580 +msgid "0.15.0 - 2021-06-13" +msgstr "" + +#: ../../../CHANGELOG.md:582 +msgid "Upgraded to `sphinx` v4 ⬆️" +msgstr "" + +#: ../../../CHANGELOG.md:584 +msgid "" +"A principe change in this release is to updates the requirements of myst-" +"parser from `sphinx>=2,<4` to `sphinx>=3,<5`." +msgstr "" + +#: ../../../CHANGELOG.md:586 +msgid "Changed MathJax handling ♻️" +msgstr "" + +#: ../../../CHANGELOG.md:588 +msgid "" +"Instead of removing all `$` processing for the whole project, during MyST" +" document parsing, the top-level section is now given the classes " +"`tex2jax_ignore` and `mathjax_ignore` (turning off default MathJax " +"processing of all HTML elements) and MathJax is then configured to " +"process elements with the `tex2jax_process|mathjax_process|math` classes." +msgstr "" + +#: ../../../CHANGELOG.md:592 +msgid "" +"See [the math syntax guide](docs/syntax/optional.md#math-shortcuts) for " +"further information." +msgstr "" + +#: ../../../CHANGELOG.md:594 +msgid "Set URL scheme defaults ‼️" +msgstr "" + +#: ../../../CHANGELOG.md:596 +msgid "" +"The `myst_url_schemes` default is now: `(\"http\", \"https\", \"mailto\"," +" \"ftp\")`. This means that only these URL will be considered as external" +" (e.g. `[](https://example.com)`), and references like `[](prefix:main)` " +"will be considered as internal references. Set `myst_url_schemes = None`," +" to revert to the previous default." +msgstr "" + +#: ../../../CHANGELOG.md:601 +msgid "Added `myst_heading_slug_func` option 👌" +msgstr "" + +#: ../../../CHANGELOG.md:603 +msgid "" +"Use this option to specify a custom function to auto-generate heading " +"anchors (see [Auto-generated header anchors](docs/syntax/optional.md" +"#auto-generated-header-anchors))." +msgstr "" + +#: ../../../CHANGELOG.md:605 +msgid "Thanks to !" +msgstr "" + +#: ../../../CHANGELOG.md:607 +msgid "0.14.0 - 2021-05-04" +msgstr "" + +#: ../../../CHANGELOG.md:609 +msgid "Upgrade to `markdown-it-py` v1.0 ⬆️" +msgstr "" + +#: ../../../CHANGELOG.md:611 +msgid "" +"This release updates the code-base to fully support the [markdown-it-" +"py](https://markdown-it-py.readthedocs.io) `v1.0.0` release. In " +"particular for users, this update alters the parsing of tables to be " +"consistent with the [Github Flavoured Markdown (GFM) " +"specification](https://github.github.com/gfm/#tables-extension-)." +msgstr "" + +#: ../../../CHANGELOG.md:614 +msgid "New Features ✨" +msgstr "" + +#: ../../../CHANGELOG.md:616 +msgid "" +"**Task lists** utilise the [markdown-it-py tasklists " +"plugin](inv:markdown_it#md/plugins), and are applied to Markdown list " +"items starting with `[ ]` or `[x]`." +msgstr "" + +#: ../../../CHANGELOG.md:623 +msgid "Add \"tasklist\" to the `myst_enable_extensions` configuration to enable." +msgstr "" + +#: ../../../CHANGELOG.md:625 +msgid "" +"See [the optional syntax guide](docs/syntax/optional.md#task-lists) for " +"further information." +msgstr "" + +#: ../../../CHANGELOG.md:627 +msgid "" +"The **`sub-ref`** role has been added for use identical to ReST's " +"`|name|` syntax." +msgstr "" + +#: ../../../CHANGELOG.md:629 +msgid "" +"This allows one to access Sphinx's built-in `|today|`, `|release|` and " +"`|version|` substitutions, and also introduces two new substitutions: " +"`wordcount-words` and `wordcount-minutes`, computed by the markdown-it-py" +" [`wordcount_plugin`](https://github.com/executablebooks/mdit-py-" +"plugins/pull/20)." +msgstr "" + +#: ../../../CHANGELOG.md:635 +msgid "" +"See [the roles syntax guide](docs/syntax/roles-and-directives.md) for " +"further information." +msgstr "" + +#: ../../../CHANGELOG.md:637 +msgid "" +"The **`dmath_double_inline`** configuration option allows display math " +"(i.e. `$$`) within an inline context. See [the math syntax " +"guide](docs/syntax/optional.md#math-shortcuts) for further information." +msgstr "" + +#: ../../../CHANGELOG.md:640 +msgid "Remove v0.13 deprecations ‼️" +msgstr "" + +#: ../../../CHANGELOG.md:642 +msgid "" +"The deprecations made to extension configurations and colon fences in " +"`0.13.0` (see below) have now been removed:" +msgstr "" + +#: ../../../CHANGELOG.md:644 +msgid "" +"Configuration variables: `myst_admonition_enable`, `myst_figure_enable`, " +"`myst_dmath_enable`, `myst_amsmath_enable`, `myst_deflist_enable`, " +"`myst_html_img_enable`" +msgstr "" + +#: ../../../CHANGELOG.md:645 +msgid "`:::{admonition,class}` -> `:::{admonition}\\n:class: class`" +msgstr "" + +#: ../../../CHANGELOG.md:646 +msgid "`:::{figure}` -> `:::{figure-md}`" +msgstr "" + +#: ../../../CHANGELOG.md:648 +msgid "Fix extraction of nested footnotes 🐛" +msgstr "" + +#: ../../../CHANGELOG.md:650 +msgid "" +"Previously footnote definitions in block elements like lists would crash " +"the parsing:" +msgstr "" + +#: ../../../CHANGELOG.md:656 +msgid "These are now correctly extracted." +msgstr "" + +#: ../../../CHANGELOG.md:658 +msgid "0.13.7 - 2021-04-25" +msgstr "" + +#: ../../../CHANGELOG.md:660 +msgid "👌 IMPROVE: Add warning for nested headers:" +msgstr "" + +#: ../../../CHANGELOG.md:662 +msgid "" +"Nested headers are not supported within most elements (this is a " +"limitation of the docutils/sphinx document structure), and can lead to " +"unexpected outcomes. For example in admonitions:" +msgstr "" + +#: ../../../CHANGELOG.md:671 +msgid "A warning (of type `myst.nested_header`) is now emitted when this occurs." +msgstr "" + +#: ../../../CHANGELOG.md:673 +msgid "🔧 MAINTAIN: Python 3.9 is now officially supported." +msgstr "" + +#: ../../../CHANGELOG.md:675 +msgid "0.13.6 - 2021-04-10" +msgstr "" + +#: ../../../CHANGELOG.md:677 +msgid "🐛 FIX: docutils `v0.17` compatibility" +msgstr "" + +#: ../../../CHANGELOG.md:679 +msgid "0.13.5 - 2021-02-15" +msgstr "" + +#: ../../../CHANGELOG.md:681 +msgid "" +"⬆️ UPGRADE: required markdown-it-py to `v0.6.2`: In particular, this " +"fixes missing source line mappings for table rows and their children" +msgstr "" + +#: ../../../CHANGELOG.md:683 +msgid "" +"👌 IMPROVE: Store `rawtext` in AST nodes: We now ensure that the raw text " +"is propagated from the Markdown tokens to the Sphinx AST. In particular, " +"this is required by the `gettext` builder, to generate translation POT " +"templates. Thanks to !" +msgstr "" + +#: ../../../CHANGELOG.md:687 +msgid "" +"✨ NEW: Add warning types `myst.subtype`: All parsing warnings are " +"assigned a type/subtype, and also the messages are appended with them. " +"These warning types can be suppressed with the sphinx `suppress_warnings`" +" config option. See [How-to suppress warnings](myst-warnings) for more " +"information." +msgstr "" + +#: ../../../CHANGELOG.md:692 +msgid "0.13.3 - 2021-01-20" +msgstr "" + +#: ../../../CHANGELOG.md:694 +msgid "Minor fixes:" +msgstr "" + +#: ../../../CHANGELOG.md:696 +msgid "🐛 FIX: front-matter parsing for bibliographic keys" +msgstr "" + +#: ../../../CHANGELOG.md:697 +msgid "🐛 FIX: directive/role name translations" +msgstr "" + +#: ../../../CHANGELOG.md:698 +msgid "👌 IMPROVE: Add warning for multiple footnote definitions" +msgstr "" + +#: ../../../CHANGELOG.md:700 +msgid "0.13.2 - 2021-01-20" +msgstr "" + +#: ../../../CHANGELOG.md:702 +msgid "✨ NEW: Add `html_admonition` extension" +msgstr "" + +#: ../../../CHANGELOG.md:704 +msgid "" +"By adding `\"html_admonition\"` to `myst_enable_extensions`, you can " +"enable parsing of `
` HTML blocks to sphinx " +"admonitions." +msgstr "" + +#: ../../../CHANGELOG.md:705 +msgid "" +"This is helpful when you care about viewing the \"source\" Markdown, such" +" as in Jupyter Notebooks." +msgstr "" + +#: ../../../CHANGELOG.md:706 +msgid "For example:" +msgstr "" + +#: ../../../CHANGELOG.md:713 +msgid "" +"See [the optional syntax guide](docs/syntax/optional.md) for further " +"information." +msgstr "" + +#: ../../../CHANGELOG.md:715 +msgid "👌 IMPROVE: Footnotes" +msgstr "" + +#: ../../../CHANGELOG.md:717 +msgid "" +"If the label is an integer, then it will always use this integer for the " +"rendered label (i.e. they are manually numbered)." +msgstr "" + +#: ../../../CHANGELOG.md:718 +msgid "" +"Add `myst_footnote_transition` configuration, to turn on/off transition " +"line." +msgstr "" + +#: ../../../CHANGELOG.md:719 +msgid "Add `footnotes` class to transition `
` in HTML." +msgstr "" + +#: ../../../CHANGELOG.md:720 +msgid "" +"See [the typography guide](docs/syntax/typography.md) for further " +"information." +msgstr "" + +#: ../../../CHANGELOG.md:722 +msgid "👌 IMPROVE: `substitution` extension logic" +msgstr "" + +#: ../../../CHANGELOG.md:724 +msgid "" +"Parse inline substitutions without block rules, unless the substitution " +"starts with a directive." +msgstr "" + +#: ../../../CHANGELOG.md:726 +msgid "🐛 FIX: Render front-matter as `field_list`" +msgstr "" + +#: ../../../CHANGELOG.md:728 +msgid "To improve use by sphinx extensions)." +msgstr "" + +#: ../../../CHANGELOG.md:730 +msgid "👌 IMPROVE: Code quality" +msgstr "" + +#: ../../../CHANGELOG.md:732 +msgid "Add isort and mypy type checking to code base." +msgstr "" + +#: ../../../CHANGELOG.md:734 +msgid "(thanks to contributors , )" +msgstr "" + +#: ../../../CHANGELOG.md:736 +msgid "0.13.1 - 2020-12-31" +msgstr "" + +#: ../../../CHANGELOG.md:738 +msgid "👌 Directives can now be used for inline substitutions, e.g." +msgstr "" + +#: ../../../CHANGELOG.md:753 +msgid "0.13.0 - 2020-12-18" +msgstr "" + +#: ../../../CHANGELOG.md:755 +msgid "" +"This release makes some major updates to the optional syntaxes. For full " +"details see [Optional MyST Syntaxes](docs/syntax/optional.md)." +msgstr "" + +#: ../../../CHANGELOG.md:758 +msgid "🗑 Deprecations" +msgstr "" + +#: ../../../CHANGELOG.md:760 +msgid "" +"`myst_enable_extensions = [\"dollarmath\", ...]` now replaces and " +"deprecates individual enable configuration variables: `admonition_enable`" +" -> `\"colon_fence\"`, `figure_enable` -> `\"colon_fence\"`, " +"`dmath_enable` -> `\"dollarmath\"`, `amsmath` -> `\"colon_fence\"`, " +"`deflist_enable` -> `\"deflist\"`, `html_img_enable` -> `\"html_image\"`." +msgstr "" + +#: ../../../CHANGELOG.md:762 +msgid "" +"The `colon_fence` extension (replacing `admonition_enable`) now works " +"exactly the same as normal ```` ``` ```` code fences, but using `:::` " +"delimiters. This is helpful for directives that contain Markdown text, " +"for example:" +msgstr "" + +#: ../../../CHANGELOG.md:772 +msgid "✨ New" +msgstr "" + +#: ../../../CHANGELOG.md:774 +msgid "" +"The `smartquotes` extension will automatically convert standard " +"quotations to their opening/closing variants:" +msgstr "" + +#: ../../../CHANGELOG.md:776 +msgid "`'single quotes'`: ‘single quotes’" +msgstr "" + +#: ../../../CHANGELOG.md:777 +msgid "`\"double quotes\"`: “double quotes”" +msgstr "" + +#: ../../../CHANGELOG.md:779 +msgid "" +"The `linkify` extension will automatically identify “bare” web URLs, like" +" `www.example.com`, and add hyperlinks; www.example.com. This extension " +"requires that [linkify-it-py](https://github.com/tsutsu3/linkify-it-py) " +"is installed." +msgstr "" + +#: ../../../CHANGELOG.md:782 +msgid "" +"The `replacements` extension will automatically convert some common " +"typographic texts, such as `+-` -> `±`." +msgstr "" + +#: ../../../CHANGELOG.md:784 +msgid "" +"The `substitution` extension allows you to specify \"substitution " +"definitions\" in either the `conf.py` (as `myst_substitutions`) and/or " +"individual file's front-matter (front-matter takes precedence), which " +"will then replace substitution references. For example:" +msgstr "" + +#: ../../../CHANGELOG.md:794 +msgid "" +"The substitutions are assessed as [jinja2 " +"expressions](http://jinja.palletsprojects.com/) and includes the [Sphinx " +"Environment](inv:sphinx#extdev/envapi) as `env`, so you can do powerful " +"thinks like:" +msgstr "" + +#: ../../../CHANGELOG.md:800 +msgid "" +"The `figure-md` directive has been added (replacing `enable_figure`), " +"which parses a \"Markdown friendly\" figure (used with the `colon_fence` " +"extension):" +msgstr "" + +#: ../../../CHANGELOG.md:812 +msgid "👌 Improvements" +msgstr "" + +#: ../../../CHANGELOG.md:814 +msgid "" +"Using the `html_image` extension, HTML images are now processed for both " +"blocks and (now) inline." +msgstr "" + +#: ../../../CHANGELOG.md:816 +msgid "So you can correctly do, for example:" +msgstr "" + +#: ../../../CHANGELOG.md:826 +msgid "0.12.10 - 2020-09-21" +msgstr "" + +#: ../../../CHANGELOG.md:828 +msgid "🐛 FIX: allow dates to be parsed in frontmatter." +msgstr "" + +#: ../../../CHANGELOG.md:829 +msgid "" +"This fixes a bug that would raise errors at parse time if non-string date" +" objects were in front-matter YAML. See " +msgstr "" + +#: ../../../CHANGELOG.md:831 +msgid "0.12.9 - 2020-09-08" +msgstr "" + +#: ../../../CHANGELOG.md:833 +msgid "✨ NEW: Auto-generate heading anchors." +msgstr "" + +#: ../../../CHANGELOG.md:834 +msgid "" +"This utilises `markdown-it-py`'s `anchors-plugin`, to generate unique " +"anchor \"slugs\" for each header (up to a certain level), and allows them" +" to be referenced *via* a relative path, e.g. `[](./file.md#header-" +"anchor)`, or in the same document, e.g. `[](#header-anchor)`." +msgstr "" + +#: ../../../CHANGELOG.md:837 +msgid "" +"Slugs are generated in the GitHub style ([see " +"here](https://github.com/Flet/github-slugger)); lower-case text, removing" +" punctuation, replacing spaces with `-`, enforce uniqueness *via* suffix " +"enumeration `-1`." +msgstr "" + +#: ../../../CHANGELOG.md:839 +msgid "" +"It is enabled in your `conf.py` *via* `myst_heading_anchors = 2` (sets " +"maximum heading level)." +msgstr "" + +#: ../../../CHANGELOG.md:841 +msgid "" +"See [the documentation here](docs/syntax/optional.md#auto-generated-" +"header-anchors)." +msgstr "" + +#: ../../../CHANGELOG.md:843 +msgid "🐛 FIX: doc reference resolution for singlehtml/latex." +msgstr "" + +#: ../../../CHANGELOG.md:844 +msgid "" +"These reference resolutions are passed to the \"missing-reference\" " +"event, and require the `node[\"refdoc\"]` attribute to be available, " +"which was missing for `[text](./path/to/file.md)` type references." +msgstr "" + +#: ../../../CHANGELOG.md:846 +msgid "0.12.7 - 2020-08-31" +msgstr "" + +#: ../../../CHANGELOG.md:848 +msgid "✨ NEW: Want to include your README.md in the documentation?" +msgstr "" + +#: ../../../CHANGELOG.md:849 +msgid "See [including a file from outside the docs folder](howto/include-readme)." +msgstr "" + +#: ../../../CHANGELOG.md:851 +msgid "(👌 added `relative-docs` option in 0.12.8)" +msgstr "" + +#: ../../../CHANGELOG.md:853 +msgid "0.12.5 - 2020-08-28" +msgstr "" + +#: ../../../CHANGELOG.md:855 +msgid "✨ NEW: Add Markdown figure syntax" +msgstr "" + +#: ../../../CHANGELOG.md:856 +msgid "" +"Setting `myst_figure_enable = True` in your sphinx `conf.py`, combines " +"the above two extended syntaxes, to create a fully Markdown compliant " +"version of the `figure` directive. See [Markdown " +"Figures](docs/syntax/optional.md#markdown-figures) for details." +msgstr "" + +#: ../../../CHANGELOG.md:860 +msgid "(👌 formatting of caption improved in 0.12.6)" +msgstr "" + +#: ../../../CHANGELOG.md:862 +msgid "0.12.4 - 2020-08-27" +msgstr "" + +#: ../../../CHANGELOG.md:864 +msgid "" +"👌 IMPROVE: the mathjax extension is now only overridden if strictly " +"necessary (to support dollar and ams math), and the override is more " +"precise, to mitigate any unwanted side-effects" +msgstr "" + +#: ../../../CHANGELOG.md:866 +msgid "0.12.3 - 2020-08-26" +msgstr "" + +#: ../../../CHANGELOG.md:868 +msgid "✨ NEW: Add definition lists." +msgstr "" + +#: ../../../CHANGELOG.md:869 +msgid "" +"This addition, enabled by `myst_deflist_enable = True`, allows for " +"\"Pandoc style\" definition lists to be parsed and rendered, e.g." +msgstr "" + +#: ../../../CHANGELOG.md:876 +msgid "" +"See the [Definition Lists documentation](https://myst-" +"parser.readthedocs.io/en/latest/syntax/optional.html#definition-lists) " +"for further details." +msgstr "" + +#: ../../../CHANGELOG.md:878 +msgid "👌 IMPROVE: mathjax_config override." +msgstr "" + +#: ../../../CHANGELOG.md:879 +msgid "" +"Only `mathjax_config[\"tex2jax\"]` will now be overridden, in order to " +"not interfere with other user configurations, such as adding TeX macros. " +"The configuration name has also changed from `myst_override_mathjax` to " +"`myst_update_mathjax`. See [Mathjax and math parsing](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#mathjax-and-math-" +"parsing) for further details." +msgstr "" + +#: ../../../CHANGELOG.md:883 +msgid "0.12.2 - 2020-08-25" +msgstr "" + +#: ../../../CHANGELOG.md:885 +msgid "✨ NEW: Add the `eval-rst` directive" +msgstr "" + +#: ../../../CHANGELOG.md:887 +msgid "" +"This directive parses its contents as ReStructuredText, which integrates " +"back into the rest of the document, e.g. for cross-referencing. See [this" +" documentation](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#how-directives-parse-" +"content) for further explanation." +msgstr "" + +#: ../../../CHANGELOG.md:889 +msgid "In particular, this addition solves some outstanding user requests:" +msgstr "" + +#: ../../../CHANGELOG.md:891 +msgid "" +"How-to [include rST files into a Markdown file](https://myst-" +"parser.readthedocs.io/en/latest/using/howto.html#include-rst-files-into-a" +"-markdown-file)" +msgstr "" + +#: ../../../CHANGELOG.md:892 +msgid "" +"How-to [Use sphinx.ext.autodoc in Markdown files](https://myst-" +"parser.readthedocs.io/en/latest/using/howto.html#use-sphinx-ext-autodoc-" +"in-markdown-files)" +msgstr "" + +#: ../../../CHANGELOG.md:894 +msgid "Thanks to for the contribution 🎉" +msgstr "" + +#: ../../../CHANGELOG.md:896 +msgid "0.12.1 - 2020-08-19" +msgstr "" + +#: ../../../CHANGELOG.md:898 +msgid "" +"✨ NEW: Add `myst_commonmark_only` config option, for restricting the " +"parser to strict CommonMark (no extensions)." +msgstr "" + +#: ../../../CHANGELOG.md:900 +msgid "0.12.0 - 2020-08-19" +msgstr "" + +#: ../../../CHANGELOG.md:902 +msgid "‼️ BREAKING" +msgstr "" + +#: ../../../CHANGELOG.md:904 +msgid "" +"If you are using math in your documents, be sure to read the updated " +"[Math syntax guide](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#math-shortcuts)! In " +"particular, the Mathjax configuration is now overridden, such that LaTeX " +"environments will only be rendered if `myst_amsmath_enable=True` is set." +msgstr "" + +#: ../../../CHANGELOG.md:907 +msgid "" +"The `myst_math_delimiters` option has also been removed (please open an " +"issue if you would like brackets math parsing to be re-implemented)." +msgstr "" + +#: ../../../CHANGELOG.md:909 +msgid "" +"In addition the `myst_html_img` option name has been changed to " +"`myst_html_img_enable`." +msgstr "" + +#: ../../../CHANGELOG.md:911 +msgid "" +"Some underlying code has also been refactored, to centralise handling of " +"configuration options (see [commit " +"98573b9](https://github.com/executablebooks/MyST-" +"Parser/commit/98573b9c6e3602ab31d627b5266ae5c1ba2c9e5f))." +msgstr "" + +#: ../../../CHANGELOG.md:913 ../../../CHANGELOG.md:923 +#: ../../../CHANGELOG.md:960 +msgid "Improved 👌" +msgstr "" + +#: ../../../CHANGELOG.md:915 +msgid "" +"More configuration options for math parsing (see [MyST configuration " +"options](https://myst-parser.readthedocs.io/en/latest/using/intro.html" +"#myst-configuration-options))." +msgstr "" + +#: ../../../CHANGELOG.md:917 +msgid "0.11.2 - 2020-07-13" +msgstr "" + +#: ../../../CHANGELOG.md:919 ../../../CHANGELOG.md:936 +msgid "Added ✨" +msgstr "" + +#: ../../../CHANGELOG.md:921 +msgid "" +"`` tag parsing to sphinx " +"representation, see [the image syntax guide](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#images)" +msgstr "" + +#: ../../../CHANGELOG.md:925 +msgid "" +"`[title](link)` syntax now works with intersphinx references. Recognised " +"URI schemas can also be configured, see the [configuration options](https" +"://myst-parser.readthedocs.io/en/latest/using/intro.html#myst-" +"configuration-options)" +msgstr "" + +#: ../../../CHANGELOG.md:928 +msgid "0.11.1 - 2020-07-12" +msgstr "" + +#: ../../../CHANGELOG.md:930 +msgid "Fix" +msgstr "" + +#: ../../../CHANGELOG.md:932 +msgid "Correctly pin required minimum markdown-it-py version" +msgstr "" + +#: ../../../CHANGELOG.md:934 +msgid "0.11.0 - 2020-07-12" +msgstr "" + +#: ../../../CHANGELOG.md:938 +msgid "Special admonition directive syntax (optional):" +msgstr "" + +#: ../../../CHANGELOG.md:946 +msgid "" +"See [the syntax guide section](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#admonition-directives-" +"special-syntax-optional) for details." +msgstr "" + +#: ../../../CHANGELOG.md:948 +msgid "" +"Direct parsing of [amsmath](https://ctan.org/pkg/amsmath) LaTeX equations" +" (optional). See [the syntax guide section](https://myst-" +"parser.readthedocs.io/en/latest/syntax/syntax.html#direct-latex-math-" +"optional) for details." +msgstr "" + +#: ../../../CHANGELOG.md:951 +msgid "Breaking ‼️" +msgstr "" + +#: ../../../CHANGELOG.md:953 +msgid "" +"Sphinx configuration options are now set as separate variables, rather " +"than a single dict. See [MyST configuration options](https://myst-" +"parser.readthedocs.io/en/latest/using/intro.html#myst-configuration-" +"options) for details." +msgstr "" + +#: ../../../CHANGELOG.md:956 +msgid "0.10.0 - 2020-07-08" +msgstr "" + +#: ../../../CHANGELOG.md:958 +msgid "" +"([full changelog](https://github.com/executablebooks/MyST-" +"Parser/compare/v0.9.1...aaed58808af485c29bbbf73c5aac10697bfa08b9))" +msgstr "" + +#: ../../../CHANGELOG.md:962 +msgid "Support Sphinx version 3 in ()" +msgstr "" + +#: ../../../CHANGELOG.md:963 +msgid "Update Trove Classifiers in ()" +msgstr "" + +#: ../../../CHANGELOG.md:964 +msgid "" +"Add functionality to use docutils specialized role in ()" +msgstr "" + +#: ../../../CHANGELOG.md:966 +msgid "Contributors to this release" +msgstr "" + +#: ../../../CHANGELOG.md:968 +msgid "" +"([GitHub contributors page for this " +"release](https://github.com/executablebooks/MyST-" +"Parser/graphs/contributors?from=2020-07-20&to=2020-08-07&type=c))" +msgstr "" + +#: ../../../CHANGELOG.md:970 +#, python-format +msgid "" +"[@AakashGfude](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3AAakashGfude+updated%3A2020-07-20..2020-08-07&type=Issues)" +" | [@asmeurer](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Aasmeurer+updated%3A2020-07-20..2020-08-07&type=Issues) " +"| [@choldgraf](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Acholdgraf+updated%3A2020-07-20..2020-08-07&type=Issues)" +" | [@chrisjsewell](https://github.com/search?q=repo%3Aexecutablebooks" +"%2FMyST-" +"Parser+involves%3Achrisjsewell+updated%3A2020-07-20..2020-08-07&type=Issues)" +" | [@codecov](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Acodecov+updated%3A2020-07-20..2020-08-07&type=Issues) |" +" [@webknjaz](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Awebknjaz+updated%3A2020-07-20..2020-08-07&type=Issues) " +"| [@welcome](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Awelcome+updated%3A2020-07-20..2020-08-07&type=Issues)" +msgstr "" + +#: ../../../CHANGELOG.md:972 +msgid "Past Releases" +msgstr "" + +#: ../../../CHANGELOG.md:974 +msgid "Contributors" +msgstr "" + +#: ../../../CHANGELOG.md:976 +msgid "" +"([GitHub contributors page for these " +"releases](https://github.com/executablebooks/MyST-" +"Parser/graphs/contributors?from=2020-01-01&to=2020-07-20&type=c))" +msgstr "" + +#: ../../../CHANGELOG.md:978 +#, python-format +msgid "" +"[@akhmerov](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Aakhmerov+updated%3A2020-01-01..2020-07-20&type=Issues) " +"| [@asmeurer](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Aasmeurer+updated%3A2020-01-01..2020-07-20&type=Issues) " +"| [@certik](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Acertik+updated%3A2020-01-01..2020-07-20&type=Issues) | " +"[@choldgraf](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Acholdgraf+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@chrisjsewell](https://github.com/search?q=repo%3Aexecutablebooks" +"%2FMyST-" +"Parser+involves%3Achrisjsewell+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@codecov](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Acodecov+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@dhermes](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Adhermes+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@filippo82](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Afilippo82+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@jlperla](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Ajlperla+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@jstac](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Ajstac+updated%3A2020-01-01..2020-07-20&type=Issues) | " +"[@martinagvilas](https://github.com/search?q=repo%3Aexecutablebooks" +"%2FMyST-" +"Parser+involves%3Amartinagvilas+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@mlncn](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Amlncn+updated%3A2020-01-01..2020-07-20&type=Issues) | " +"[@mmcky](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Ammcky+updated%3A2020-01-01..2020-07-20&type=Issues) | " +"[@moorepants](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Amoorepants+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@najuzilu](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Anajuzilu+updated%3A2020-01-01..2020-07-20&type=Issues) " +"| [@nathancarter](https://github.com/search?q=repo%3Aexecutablebooks" +"%2FMyST-" +"Parser+involves%3Anathancarter+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@pauleveritt](https://github.com/search?q=repo%3Aexecutablebooks" +"%2FMyST-" +"Parser+involves%3Apauleveritt+updated%3A2020-01-01..2020-07-20&type=Issues)" +" | [@phaustin](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Aphaustin+updated%3A2020-01-01..2020-07-20&type=Issues) " +"| [@rossbar](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Arossbar+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@rowanc1](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Arowanc1+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@sbliven](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Asbliven+updated%3A2020-01-01..2020-07-20&type=Issues) |" +" [@webknjaz](https://github.com/search?q=repo%3Aexecutablebooks%2FMyST-" +"Parser+involves%3Awebknjaz+updated%3A2020-01-01..2020-07-20&type=Issues)" +msgstr "" + +#: ../../../docs/develop/architecture.md:1 +msgid "The MyST implementation architecture" +msgstr "" + +#: ../../../docs/develop/architecture.md:3 +msgid "" +"This page describes implementation details to help you understand the " +"structure of the project." +msgstr "" + +#: ../../../docs/develop/architecture.md:6 +msgid "A Renderer for markdown-it tokens" +msgstr "" + +#: ../../../docs/develop/architecture.md:8 +msgid "" +"At a high level, the MyST parser is an extension of the Markdown-It-Py " +"project. Markdown-It-Py is a well-structured Python parser for CommonMark" +" text. It also defines an extension point to include more syntax in " +"parsed files. The MyST parser uses this extension point to define its own" +" syntax options (e.g., for Sphinx roles and directives)." +msgstr "" + +#: ../../../docs/develop/architecture.md:13 +msgid "The result of this parser is a markdown-it token stream." +msgstr "" + +#: ../../../docs/develop/architecture.md:15 +msgid "A docutils renderer" +msgstr "" + +#: ../../../docs/develop/architecture.md:17 +msgid "" +"The MyST parser also defines a docutils renderer for the markdown-it " +"token stream. This allows us to convert parsed elements of a MyST " +"markdown file into docutils." +msgstr "" + +#: ../../../docs/develop/architecture.md:20 +msgid "A Sphinx parser" +msgstr "" + +#: ../../../docs/develop/architecture.md:22 +msgid "" +"Finally, the MyST parser provides a parser for Sphinx, the documentation " +"generation system. This parser does the following:" +msgstr "" + +#: ../../../docs/develop/architecture.md:25 +msgid "" +"Parse markdown files with the markdown-it parser, including MyST specific" +" plugins" +msgstr "" + +#: ../../../docs/develop/architecture.md:26 +msgid "Convert these files into docutils objects using the MyST docutils renderer" +msgstr "" + +#: ../../../docs/develop/architecture.md:27 +msgid "Provide these to Sphinx in order to use in building your site." +msgstr "" + +#: ../../../docs/develop/background.md:1 +msgid "Background" +msgstr "" + +#: ../../../docs/develop/background.md:3 +msgid "" +"These sections discuss high-level questions about the MyST ecosystem, and" +" explain a few decisions made in the project." +msgstr "" + +#: ../../../docs/develop/background.md:5 +msgid "Why did we create MyST markdown?" +msgstr "" + +#: ../../../docs/develop/background.md:7 +msgid "" +"While markdown is ubiquitous, it is not powerful enough for writing " +"modern, fully-featured documentation. Some flavors of markdown support " +"features needed for this, but there is no community standard around " +"various syntactic choices for these features." +msgstr "" + +#: ../../../docs/develop/background.md:11 +msgid "" +"Sphinx is a documentation generation framework written in Python. It " +"heavily-utilizes reStructuredText syntax, which is another markup " +"language for writing documents. In particular, Sphinx defines two " +"extension points that are extremely useful: **{ref}`in-line roles`** and **{ref}`block-level directives `**." +msgstr "" + +#: ../../../docs/develop/background.md:16 +msgid "" +"**This project is an attempt at combining the simplicity and readability " +"of Markdown with the power and flexibility of reStructuredText and the " +"Sphinx platform.** It starts with the [CommonMark markdown " +"specification][commonmark], and selectively adds a few extra syntax " +"pieces to utilize the most powerful parts of reStructuredText." +msgstr "" + +#: ../../../docs/develop/background.md:22 +msgid "" +"The CommonMark community has been discussing an \"official\" extension " +"syntax for many years now (for example, see [this seven-year-old thread " +"about directives](https://talk.commonmark.org/t/generic-directives-" +"plugins-syntax/444) as well as [this more recent " +"conversation](https://talk.commonmark.org/t/support-for-extension-" +"token/2771), and [this comment listing several more threads on this " +"topic](https://talk.commonmark.org/t/extension-terminology-and-" +"rules/1233))." +msgstr "" + +#: ../../../docs/develop/background.md:28 +msgid "" +"We have chosen a \"roles and directives\" syntax that seems reasonable " +"and follows other common conventions in Markdown flavors. However, if the" +" CommonMark community ever decides on an \"official\" extension syntax, " +"we will likely utilize this syntax for MyST." +msgstr "" + +#: ../../../docs/develop/background.md:34 +msgid "The relationship between MyST, reStructuredText, and Sphinx" +msgstr "" + +#: ../../../docs/develop/background.md:36 +msgid "" +"MyST markdown provides a markdown equivalent of the reStructuredText " +"syntax, meaning that you can do anything in MyST that you can do with " +"reStructuredText." +msgstr "" + +#: ../../../docs/develop/background.md:39 +msgid "" +"The Sphinx documentation engine supports a number of different input " +"types. By default, Sphinx reads **reStructuredText** (`.rst`) files. " +"Sphinx uses a **parser** to parse input files into its own internal " +"document model (which is provided by a core Python project, " +"[docutils](https://docutils.sourceforge.io/))." +msgstr "" + +#: ../../../docs/develop/background.md:44 +msgid "" +"Developers can *extend Sphinx* to support other kinds of input files. Any" +" content file can be read into the Sphinx document structure, provided " +"that somebody writes a **parser** for that file. Once a content file has " +"been parsed into Sphinx, it behaves nearly the same way as any other " +"content file, regardless of the language in which it was written." +msgstr "" + +#: ../../../docs/develop/background.md:50 +msgid "" +"The MyST-parser is a Sphinx parser for the MyST markdown language. When " +"you use it, Sphinx will know how to parse content files that contain MyST" +" markdown (by default, Sphinx will assume any files ending in `.md` are " +"written in MyST markdown). Once a document has been parsed into Sphinx, " +"it behaves the same way regardless of whether it has been written in rST " +"or MyST markdown." +msgstr "" + +#: ../../../docs/develop/background.md:61 +msgid "" +"For example, here's how you'd write a `toctree` directive in MyST " +"markdown:" +msgstr "" + +#: ../../../docs/develop/background.md:70 +msgid "and here's the same in rST:" +msgstr "" + +#: ../../../docs/develop/background.md:79 +msgid "They will both behave the same in Sphinx." +msgstr "" + +#: ../../../docs/develop/contributing.md:1 +msgid "Contributing" +msgstr "" + +#: ../../../docs/develop/contributing.md:3 +msgid "" +"[![Github-CI][github-ci]][github-link] [![Coverage Status][codecov-badge" +"]][codecov-link] [![Documentation Status][rtd-badge]][rtd-link] [![Code " +"style: black][black-badge]][black-link]" +msgstr "" + +#: ../../../docs/develop/contributing.md:3 +msgid "Github-CI" +msgstr "" + +#: ../../../docs/develop/contributing.md:3 +msgid "Coverage Status" +msgstr "" + +#: ../../../docs/develop/contributing.md:3 +msgid "Documentation Status" +msgstr "" + +#: ../../../docs/develop/contributing.md:3 +msgid "Code style: black" +msgstr "" + +#: ../../../docs/develop/contributing.md:8 +msgid "" +"We welcome all contributions! See the [EBP Contributing " +"Guide](https://executablebooks.org/en/latest/contributing.html) for " +"general details, and below for guidance specific to MyST-Parser." +msgstr "" + +#: ../../../docs/develop/contributing.md:11 +msgid "Install for development" +msgstr "" + +#: ../../../docs/develop/contributing.md:13 +msgid "To install `myst-parser` for development, take the following steps:" +msgstr "" + +#: ../../../docs/develop/contributing.md:22 +msgid "Code Style" +msgstr "" + +#: ../../../docs/develop/contributing.md:24 +msgid "" +"Code style is tested using [flake8](http://flake8.pycqa.org), with the " +"configuration set in `.flake8`, and code formatted with " +"[black](https://github.com/ambv/black)." +msgstr "" + +#: ../../../docs/develop/contributing.md:28 +msgid "" +"Installing with `myst-parser[code_style]` makes the [pre-commit](https" +"://pre-commit.com/) package available, which will ensure this style is " +"met before commits are submitted, by reformatting the code and testing " +"for lint errors. It can be setup by:" +msgstr "" + +#: ../../../docs/develop/contributing.md:38 +msgid "Optionally you can run `black` and `flake8` separately:" +msgstr "" + +#: ../../../docs/develop/contributing.md:45 +msgid "" +"Editors like VS Code also have automatic code reformat utilities, which " +"can adhere to this standard." +msgstr "" + +#: ../../../docs/develop/contributing.md:47 +msgid "" +"All functions and class methods should be annotated with types and " +"include a docstring. The preferred docstring format is outlined in `MyST-" +"Parser/docstring.fmt.mustache` and can be used automatically with the " +"[autodocstring](https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring)" +" VS Code extension." +msgstr "" + +#: ../../../docs/develop/contributing.md:50 +msgid "Testing" +msgstr "" + +#: ../../../docs/develop/contributing.md:52 +msgid "For code tests, myst-parser uses [pytest](https://docs.pytest.org):" +msgstr "" + +#: ../../../docs/develop/contributing.md:59 +msgid "" +"You can also use [tox](https://tox.readthedocs.io), to run the tests in " +"multiple isolated environments (see the `tox.ini` file for available test" +" environments):" +msgstr "" + +#: ../../../docs/develop/contributing.md:66 +msgid "For documentation build tests:" +msgstr "" + +#: ../../../docs/develop/contributing.md:75 +msgid "{ref}`develop/testing`" +msgstr "" + +#: ../../../docs/develop/index.md:1 +msgid "Contribute" +msgstr "" + +#: ../../../docs/develop/index.md:3 +msgid "" +"This section covers documentation relevant to developing and maintaining " +"the MyST codebase, and some guidelines for how you can contribute." +msgstr "" + +#: ../../../docs/develop/index.md:12 +msgid "Code of Conduct" +msgstr "" + +#: ../../../docs/develop/index.md:14 +msgid "" +"The MyST-parser project follows the [Executable Book Project code of " +"conduct](https://github.com/executablebooks/.github/blob/master/CODE_OF_CONDUCT.md)." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:3 +msgid "Testing Infrastructure" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:5 +msgid "" +"Where possible, additions to the code should be carried out in a [test-" +"driven development](https://en.wikipedia.org/wiki/Test-" +"driven_development) manner:" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:9 +msgid "" +"**Write failing tests that the code should pass, then write code to pass " +"the tests**." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:11 +msgid "" +"The tests are run using [pytest](https://docs.pytest.org)/[GitHub " +"Actions](https://github.com/features/actions) for unit tests, and " +"[readthedocs](https://readthedocs.org/) for documentation build tests." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:13 +msgid "The tests are ordered in a hierarchical fashion:" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:15 +msgid "" +"In `tests/test_commonmark` the " +"[CommonMark](https://github.com/commonmark/CommonMark.git) test set is " +"run to check that the parser is complying with the CommonMark " +"specification." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:16 +msgid "" +"In `tests/test_renderers` are tests that check that the Markdown AST is " +"being correctly converted to the docutils/sphinx AST. This includes " +"testing that roles and directives are correctly parsed and run." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:17 +msgid "" +"In `tests/test_sphinx` are tests that check that minimal sphinx project " +"builds are running correctly, to convert MyST markdown files to HTML." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:18 +msgid "" +"In `.circleci` the package documentation (written in MyST format) is " +"built and tested for build errors/warnings." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:20 +msgid "Test tools" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:22 +msgid "" +"[**pytest-regressions**](https://pytest-regressions.readthedocs.io) is a " +"pytest plugin that is used in the test suite, to maintain tests that " +"generate lots of data. In particular, they are used in the syntax testing" +" to generate tests for AST trees which may change in the future due to " +"changes/additions to the data captured by the parser. For example, after " +"writing:" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:39 +msgid "" +"Running the following will initially fail, but will also generate a file " +"(per test) of expected output:" +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:46 +msgid "" +"Subsequent times the tests are run, the tests output will now be " +"validated against these stored files." +msgstr "" + +#: ../../../docs/develop/test_infrastructure.md:48 +msgid "" +"After a change to the syntax parser, all failing tests can then be " +"'regenerated' with the new expected output, by running:" +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/docutils.po b/locales/zh_CN/LC_MESSAGES/docutils.po new file mode 100644 index 00000000..4f75d891 --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/docutils.po @@ -0,0 +1,114 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/docutils.md:3 +msgid "Single Page Builds" +msgstr "" + +#: ../../../docs/docutils.md:8 +msgid "" +"Sphinx, and thus MyST-Parser, is built on top of the " +"[Docutils](https://docutils.sourceforge.io/docs/) package. MyST-Parser " +"offers a renderer, parser and CLI-interface for working directly with " +"Docutils, independent of Sphinx, as described below." +msgstr "" + +#: ../../../docs/docutils.md:12 +msgid "" +"Since these tools are independent of Sphinx, this means they cannot parse" +" any Sphinx or Sphinx extensions specific roles or directives." +msgstr "" + +#: ../../../docs/docutils.md:15 +msgid "On installing MyST-Parser, the following CLI-commands are made available:" +msgstr "" + +#: ../../../docs/docutils.md:17 +msgid "`myst-docutils-html`: converts MyST to HTML" +msgstr "" + +#: ../../../docs/docutils.md:18 +msgid "`myst-docutils-html5`: converts MyST to HTML5" +msgstr "" + +#: ../../../docs/docutils.md:19 +msgid "`myst-docutils-latex`: converts MyST to LaTeX" +msgstr "" + +#: ../../../docs/docutils.md:20 +msgid "`myst-docutils-xml`: converts MyST to docutils-native XML" +msgstr "" + +#: ../../../docs/docutils.md:21 +msgid "" +"`myst-docutils-pseudoxml`: converts MyST to pseudo-XML (to visualise the " +"AST structure)" +msgstr "" + +#: ../../../docs/docutils.md:23 +msgid "Each command can be piped stdin or take a file path as an argument:" +msgstr "" + +#: ../../../docs/docutils.md:31 +msgid "" +"The commands are based on the [Docutils Front-End " +"Tools](https://docutils.sourceforge.io/docs/user/tools.html), and so " +"follow the same argument and options structure, included many of the MyST" +" specific options detailed in [](sphinx/config-options)." +msgstr "" + +#: ../../../docs/docutils.md +msgid "Shared Docutils CLI Options" +msgstr "" + +#: ../../../docs/docutils.md:39 +msgid "" +"`myst-suppress-warnings` replicates the functionality of sphinx's " +" for `myst.` warnings in the `docutils` " +"CLI." +msgstr "" + +#: ../../../docs/docutils.md:42 +msgid "" +"The CLI commands can also utilise the [`docutils.conf` configuration " +"file](https://docutils.sourceforge.io/docs/user/config.html) to configure" +" the behaviour of the CLI commands. For example:" +msgstr "" + +#: ../../../docs/docutils.md:62 +msgid "" +"You can also use the {py:class}`myst_parser.parsers.docutils_.Parser` " +"class programmatically with the [Docutils publisher " +"API](https://docutils.sourceforge.io/docs/api/publisher.html):" +msgstr "" + +#: ../../../docs/docutils.md:80 +msgid "" +"Finally, you can include MyST Markdown files within a RestructuredText " +"file, using the [`include` " +"directive](https://docutils.sourceforge.io/docs/ref/rst/directives.html#include):" +msgstr "" + +#: ../../../docs/docutils.md:88 +msgid "The `parser` option requires `docutils>=0.17`" +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/faq.po b/locales/zh_CN/LC_MESSAGES/faq.po new file mode 100644 index 00000000..195bba89 --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/faq.po @@ -0,0 +1,316 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/faq/index.md:3 +msgid "FAQ" +msgstr "" + +#: ../../../docs/faq/index.md:5 +msgid "How-tos" +msgstr "" + +#: ../../../docs/faq/index.md:7 +msgid "" +"These sections describe some common scenarios and use-cases for writing " +"MyST with Sphinx." +msgstr "" + +#: ../../../docs/faq/index.md:10 +msgid "Include rST files into a Markdown file" +msgstr "" + +#: ../../../docs/faq/index.md:12 +msgid "" +"As explained in [this section](#syntax/directives/parsing), all MyST " +"directives will parse their content as Markdown. Therefore, using the " +"conventional `include` directive, will parse the file contents as " +"Markdown:" +msgstr "" + +#: ../../../docs/faq/snippets/include-md.md:1 +#: ../../../docs/faq/snippets/include-md.md:2 +msgid "Hallo I'm from a Markdown file, [with a reference](#howto/autodoc)." +msgstr "" + +#: ../../../docs/faq/index.md:23 +msgid "" +"To include rST, we must first \"wrap\" the directive in the [eval-rst " +"directive](#syntax/directives/parsing):" +msgstr "" + +#: ../../../docs/faq/snippets/include-rst.rst:1 +msgid "Hallo I'm from an rST file, :ref:`with a reference `." +msgstr "" + +#: ../../../docs/faq/index.md:36 +msgid "Include Markdown files into an rST file" +msgstr "" + +#: ../../../docs/faq/index.md:38 +msgid "" +"To include a MyST file within a ReStructuredText file, we can use the " +"`parser` option of the `include` directive:" +msgstr "" + +#: ../../../docs/faq/index.md:46 +msgid "The `parser` option requires `docutils>=0.17`" +msgstr "" + +#: ../../../docs/faq/index.md:49 +msgid "Use MyST in Jupyter Notebooks" +msgstr "" + +#: ../../../docs/faq/index.md:51 +msgid "" +"The [MyST-NB](https://myst-nb.readthedocs.io) tool provides a Sphinx " +"extension for parsing **Jupyter Notebooks written with MyST Markdown**. " +"It includes features like automatically executing notebooks during " +"documentation builds, storing notebook cell outputs in order to insert " +"them elsewhere in your documentation, and more. See the [MyST-NB " +"documentation](https://myst-nb.readthedocs.io) for more information." +msgstr "" + +#: ../../../docs/faq/index.md:54 +msgid "Include a file from outside the docs folder (like README.md)" +msgstr "" + +#: ../../../docs/faq/index.md:57 +msgid "" +msgstr "" + +#: ../../../docs/faq/index.md:60 +msgid "You can include a file, including one from outside the project using e.g.:" +msgstr "" + +#: ../../../docs/faq/index.md:67 +msgid "" +"**However**, including a file will not usually resolve local links " +"correctly, like `![](my-image.png)`, since it treats the text as if it " +"originated from the \"including file\"." +msgstr "" + +#: ../../../docs/faq/index.md:69 +msgid "" +"As of myst-parser version 0.12.7, a new, experimental feature has been " +"added to resolve such links. You can now use for example:" +msgstr "" + +#: ../../../docs/faq/index.md:84 +msgid "Source:" +msgstr "" + +#: ../../../docs/faq/index.md:90 +msgid "Included:" +msgstr "" + +#: ../../../example-include.md:2 +msgid "[Used in how-to](docs/faq/index.md) ![alt](docs/_static/logo-wide.svg)" +msgstr "" + +#: ../../../example-include.md:2 +msgid "alt" +msgstr "" + +#: ../../../docs/faq/index.md:97 +msgid "" +"The include here attempts to re-write local links, to reference them from" +" the correct location! The `relative-docs` must be given the prefix of " +"any links to re-write, to distinguish them from sphinx cross-references." +msgstr "" + +#: ../../../docs/faq/index.md:101 +msgid "The current functionality only works for Markdown style images and links." +msgstr "" + +#: ../../../docs/faq/index.md:103 +msgid "" +"If you encounter any issues with this feature, please don't hesitate to " +"report it." +msgstr "" + +#: ../../../docs/faq/index.md:107 +msgid "Use `sphinx.ext.autodoc` in Markdown files" +msgstr "" + +#: ../../../docs/faq/index.md:109 +msgid "See [](#syntax/apis) for this information." +msgstr "" + +#: ../../../docs/faq/index.md:112 +msgid "Automatically create targets for section headers" +msgstr "" + +#: ../../../docs/faq/index.md:115 +msgid "See [](#syntax/implicit-targets) for this information." +msgstr "" + +#: ../../../docs/faq/index.md:119 +msgid "Suppress warnings" +msgstr "" + +#: ../../../docs/faq/index.md:121 +msgid "See for this information." +msgstr "" + +#: ../../../docs/faq/index.md:123 +msgid "Sphinx-specific page front matter" +msgstr "" + +#: ../../../docs/faq/index.md:125 +msgid "" +"Sphinx intercepts front matter and stores them within the global " +"environment (as discussed in the [sphinx documentation](inv:sphinx#usage" +"/*/field-lists)). There are certain front-matter keys (or their " +"translations) that are also recognised specifically by docutils and " +"parsed to inline Markdown:" +msgstr "" + +#: ../../../docs/faq/index.md:129 +msgid "`author`" +msgstr "" + +#: ../../../docs/faq/index.md:130 +msgid "`authors`" +msgstr "" + +#: ../../../docs/faq/index.md:131 +msgid "`organization`" +msgstr "" + +#: ../../../docs/faq/index.md:132 +msgid "`address`" +msgstr "" + +#: ../../../docs/faq/index.md:133 +msgid "`contact`" +msgstr "" + +#: ../../../docs/faq/index.md:134 +msgid "`version`" +msgstr "" + +#: ../../../docs/faq/index.md:135 +msgid "`revision`" +msgstr "" + +#: ../../../docs/faq/index.md:136 +msgid "`status`" +msgstr "" + +#: ../../../docs/faq/index.md:137 +msgid "`date`" +msgstr "" + +#: ../../../docs/faq/index.md:138 +msgid "`copyright`" +msgstr "" + +#: ../../../docs/faq/index.md:139 +msgid "`dedication`" +msgstr "" + +#: ../../../docs/faq/index.md:140 +msgid "`abstract`" +msgstr "" + +#: ../../../docs/faq/index.md:142 +msgid "" +"A classic use-case is to specify 'orphan' documents, that are not " +"specified in any toctrees. For example, inserting the following syntax at" +" the top of a page will cause Sphinx to treat it as an orphan page:" +msgstr "" + +#: ../../../docs/faq/index.md:153 +msgid "Migrate pre-existing rST into MyST" +msgstr "" + +#: ../../../docs/faq/index.md:155 +msgid "" +"If you've already got some reStructuredText files that you'd like to " +"convert into MyST Markdown, try the [`rst-to-" +"myst`](https://github.com/executablebooks/rst-to-myst) tool, which allows" +" you to convert single rST files to MyST markdown documents." +msgstr "" + +#: ../../../docs/faq/index.md:157 +msgid "Disable Markdown syntax for the parser" +msgstr "" + +#: ../../../docs/faq/index.md:159 +msgid "" +"If you'd like to either enable or disable custom markdown syntax, use " +"`myst_disable_syntax`. Anything in this list will no longer be parsed by " +"the MyST parser." +msgstr "" + +#: ../../../docs/faq/index.md:162 +msgid "" +"For example, to disable the `emphasis` in-line syntax, use this " +"configuration:" +msgstr "" + +#: ../../../docs/faq/index.md:168 +msgid "" +"emphasis syntax will now be disabled. For example, the following will be " +"rendered *without* any italics:" +msgstr "" + +#: ../../../docs/faq/index.md:175 +msgid "" +"For a list of all the syntax elements you can disable, see the [markdown-" +"it parser guide](inv:markdown_it#using)." +msgstr "" + +#: ../../../docs/faq/index.md:177 +msgid "Common errors and questions" +msgstr "" + +#: ../../../docs/faq/index.md:179 +msgid "" +"These are common issues and gotchas that people may experience when using" +" the MyST Sphinx extension." +msgstr "" + +#: ../../../docs/faq/index.md:181 +msgid "What markup language should I use inside directives?" +msgstr "" + +#: ../../../docs/faq/index.md:183 +msgid "" +"If you need to parse content *inside* of another block of content (for " +"example, the content inside a **note directive**), note that the MyST " +"parser will be used for this nested parsing as well." +msgstr "" + +#: ../../../docs/faq/index.md:187 +msgid "Why doesn't my role/directive recognize markdown link syntax?" +msgstr "" + +#: ../../../docs/faq/index.md:189 +msgid "" +"There are some roles/directives that _hard-code_ syntax into their " +"behavior. For example, many roles allow you to supply titles for links " +"like so: `` {role}`My title ` ``. While this looks like " +"reStructuredText, the role may be explicitly expecting the `My title " +"` structure, and so MyST will behave the same way." +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/index.po b/locales/zh_CN/LC_MESSAGES/index.po new file mode 100644 index 00000000..51eca84b --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/index.po @@ -0,0 +1,224 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/index.md:120 +msgid "✏️ Authoring" +msgstr "✏️ 创作" + +#: ../../../docs/index.md:133 +msgid "📚 Guides" +msgstr "📚 指南" + +#: ../../../docs/index.md:145 +msgid "📖 Reference" +msgstr "📖 参考资料" + +#: ../../../docs/index.md:5 +msgid "🔎 Overview" +msgstr "🔎 概览" + +#: ../../../docs/index.md +msgid "MyST - Markedly Structured Text - Parser" +msgstr "MyST - Markedly Structured Text - 解析器" + +#: ../../../docs/index.md:33 +msgid "" +"A Sphinx and Docutils extension to parse MyST, a rich and extensible " +"flavour of Markdown for authoring technical and scientific documentation." +msgstr "" +"用于解析 MyST 的 Sphinx 和 Docutils 扩展，MyST 是一种丰富且可扩展的 Markdown 风格，用于编写技术和科学文档。" + +#: ../../../docs/index.md:37 +msgid "Get Started" +msgstr "" + +#: ../../../docs/index.md:45 +msgid "Live Demo" +msgstr "" + +#: ../../../docs/index.md:62 +msgid "" +" CommonMark-plus" +msgstr "" + +#: ../../../docs/index.md:66 +msgid "" +"MyST extends the CommonMark syntax specification, to support technical " +"authoring features such as tables and footnotes." +msgstr "" +"MyST 扩展了 CommonMark 语法规范，以支持诸如表格和脚注等技术写作功能。" + +#: ../../../docs/index.md:69 +msgid "[Learn more »](syntax/core)" +msgstr "[了解更多 »](syntax/core)" + +#: ../../../docs/index.md:72 +msgid "" +" Sphinx compatible" +msgstr "" +" Sphinx 兼容" + +#: ../../../docs/index.md:76 +msgid "" +"Use the MyST role and directive syntax to harness the full capability of " +"Sphinx, such as admonitions and figures, and all existing Sphinx " +"extensions." +msgstr "" +"使用 MyST 角色和指令语法来充分利用 Sphinx 的全部功能，例如提示框和图表，以及所有现有的 Sphinx 扩展。" + +#: ../../../docs/index.md:79 +msgid "[Learn more »](roles-directives)" +msgstr "[了解更多 »](roles-directives)" + +#: ../../../docs/index.md:82 +msgid "" +" Highly configurable" +msgstr "" +" 高度可配置" + +#: ../../../docs/index.md:86 +msgid "" +"MyST-parser can be configured at both the global and individual document " +"level, to modify parsing behaviour and access extended syntax features." +msgstr "" +"MyST-parser 可以在全局和单个文档级别进行配置，以修改解析行为并访问扩展语法功能。" + +#: ../../../docs/index.md:90 +msgid "[Learn more »](configuration)" +msgstr "[了解更多 »](configuration)" + +#: ../../../docs/index.md:96 +msgid "Additional resources" +msgstr "附加资源" + +#: ../../../docs/index.md:99 +msgid "" +"[MyST-Markdown VS Code " +"extension](https://marketplace.visualstudio.com/items?itemName=ExecutableBookProject" +".myst-highlight)" +msgstr "" +"[MyST-Markdown VS Code " +"插件](https://marketplace.visualstudio.com/items?itemName=ExecutableBookProject" +".myst-highlight)" + +#: ../../../docs/index.md:100 +msgid "For MyST extended syntax highlighting and authoring tools." +msgstr "对于 MyST 扩展语法高亮和创作工具" + +#: ../../../docs/index.md:102 +msgid "[Convert existing ReStructuredText files to Markdown][rst-to-myst]" +msgstr "" +# "[将现有的 ReStructuredText 文件转换为 Markdown][rst-to-myst]" + +#: ../../../docs/index.md:103 +msgid "" +"Use the [rst-to-myst] CLI or [the MySTyc interactive web " +"interface](https://astrojuanlu.github.io/mystyc/)." +msgstr "" +# "使用 [rst-to-myst] CLI 或 [MySTyc 交互式网页接口](https://astrojuanlu.github.io/mystyc/)。" + +#: ../../../docs/index.md:105 +msgid "[markdown-it-py]" +msgstr "" + +#: ../../../docs/index.md:106 +msgid "" +"A CommonMark-compliant and extensible Markdown parser, used by MyST-" +"Parser to parse source text to tokens." +msgstr "" +"符合 CommonMark 标准且可扩展的 Markdown 解析器，由 MyST-Parser 用于将源文本解析为标记（tokens）。" + +#: ../../../docs/index.md:108 +msgid "Acknowledgements" +msgstr "致谢" + +#: ../../../docs/index.md:111 +msgid "" +"The MyST markdown language and MyST parser are both supported by the open" +" community, [The Executable Book Project](https://executablebooks.org)." +msgstr "" +"MyST Markdown 语言和 MyST 解析器均由开源社区 [可执行图书项目](https://executablebooks.org) 支持。" diff --git a/locales/zh_CN/LC_MESSAGES/intro.po b/locales/zh_CN/LC_MESSAGES/intro.po new file mode 100644 index 00000000..bbb03ce6 --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/intro.po @@ -0,0 +1,332 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/intro.md:2 +msgid "🚀 Get Started" +msgstr "🚀 开始使用" + +#: ../../../docs/intro.md:4 +msgid "" +"This page gives a quick overview of how to get started with MyST " +"Markdown, and how to use it within Docutils and Sphinx." +msgstr "" +"本页简要概述了如何开始使用 MyST Markdown，以及如何在 Docutils 和 Sphinx 中使用它。" + +#: ../../../docs/intro.md:6 +msgid "Installation" +msgstr "安装" + +#: ../../../docs/intro.md:8 +msgid "[![PyPI][pypi-badge]][pypi-link] [![Conda][conda-badge]][conda-link]" +msgstr "" + +#: ../../../docs/intro.md:8 +msgid "PyPI" +msgstr "" + +#: ../../../docs/intro.md:8 +msgid "Conda" +msgstr "" + +#: ../../../docs/intro.md:11 +msgid "To install myst-parser use [pip](https://pip.pypa.io):" +msgstr "要安装 `myst-parser`，请使用 [pip](https://pip.pypa.io)：" + +#: ../../../docs/intro.md:17 +msgid "or [Conda](https://docs.conda.io):" +msgstr "或者 [Conda](https://docs.conda.io):" + +#: ../../../docs/intro.md:29 +msgid "Write a Markdown document" +msgstr "编写 Markdown 文档" + +#: ../../../docs/intro.md:31 +msgid "" +"To start off, create an empty file called `example.md` and give it a " +"Markdown title and text. We can now use the `myst-docutils-demo` [CLI " +"tool](docutils.md), from the installed package, to parse this file to " +"HTML:" +msgstr "" +"首先，创建名为 `example.md` 的空文件，并为其添加 Markdown 标题和文本。" +"然后，可以使用已安装包中的 `myst-docutils-demo` [命令行工具](docutils.md) 将此文件解析为 HTML：" + +#: ../../../docs/intro.md:40 +msgid "Extend Markdown with MyST syntax" +msgstr "使用 MyST 语法扩展 Markdown" + +#: ../../../docs/intro.md:42 +msgid "" +"MyST is an extension of [CommonMark Markdown](https://commonmark.org/), " +"that includes a rich [additional syntax](syntax/typography.md) for " +"technical authoring, and can integrate with Docutils and Sphinx." +msgstr "" + +#: ../../../docs/intro.md:46 +msgid "" +"For example, MyST includes {{role}} and {{directive}} extensions points, " +"to allow for richer features, such as " +"[admonitions](syntax/admonitions.md) and " +"[figures](syntax/images_and_figures.md)." +msgstr "" + +#: ../../../docs/intro.md:48 +msgid "" +"Lets add an `admonition` directive and `sup` role to your Markdown page, " +"like so:" +msgstr "" + +#: ../../../docs/intro.md:67 +msgid "MyST works with just about all Docutils and Sphinx roles and directives." +msgstr "" + +#: ../../../docs/intro.md:69 +msgid "" +"Note, Sphinx provides a superset of the Docutils roles and directives, so" +" some may not work in the Docutils CLI." +msgstr "" + +#: ../../../docs/intro.md:73 +msgid "Cross-referencing" +msgstr "" + +#: ../../../docs/intro.md:75 +msgid "" +"MyST-Parser offers powerful [cross-referencing features](syntax/cross-" +"referencing.md), to link to documents, headers, figures and more." +msgstr "" + +#: ../../../docs/intro.md:77 +msgid "For example, to add a section *reference target*, and reference it:" +msgstr "" + +#: ../../../docs/intro.md:87 +msgid "Enable MyST in Sphinx" +msgstr "" + +#: ../../../docs/intro.md:89 +msgid "" +"To get started with Sphinx, see their [quick-start " +"guide](inv:sphinx#usage/quickstart)." +msgstr "" + +#: ../../../docs/intro.md:91 +msgid "" +"To use the MyST parser in Sphinx, simply add the following to your " +"`conf.py` [configuration file](inv:sphinx#usage/configuration):" +msgstr "" + +#: ../../../docs/intro.md:97 +msgid "" +"This will activate the MyST Parser extension, causing all documents with " +"the `.md` extension to be parsed as MyST." +msgstr "" + +#: ../../../docs/intro.md:99 +msgid "" +"Our `example.md` file can now be added as the [index " +"page](inv:sphinx#usage/index), or see the [organising content " +"section](#syntax/toctree) about creating `toctree` directives, to add " +"`example.md` to." +msgstr "" + +#: ../../../docs/intro.md:103 +msgid "" +"There are a range of great HTML themes that work well with MyST, such as " +"[sphinx-book-theme](https://github.com/executablebooks/sphinx-book-theme)" +" (used here), [pydata-sphinx-theme](https://github.com/pydata/pydata-" +"sphinx-theme/) and [furo](https://github.com/pradyunsg/furo)" +msgstr "" + +#: ../../../docs/intro.md:108 +msgid "Configuring MyST-Parser" +msgstr "" + +#: ../../../docs/intro.md:110 +msgid "" +"The section contains a complete list of " +"configuration options for the MyST-Parser." +msgstr "" + +#: ../../../docs/intro.md:112 +msgid "These can be applied globally, e.g. in the sphinx `conf.py`:" +msgstr "" + +#: ../../../docs/intro.md:118 +msgid "" +"Or they can be applied to specific documents, at the top of the document," +" in frontmatter:" +msgstr "" + +#: ../../../docs/intro.md:127 +msgid "Extending Sphinx" +msgstr "" + +#: ../../../docs/intro.md:129 +msgid "" +"The other way to extend MyST in Sphinx is to install Sphinx extensions " +"that define new roles, directives, etc." +msgstr "" + +#: ../../../docs/intro.md:131 +msgid "" +"For example, let's install the [sphinx-" +"design](https://github.com/executablebooks/sphinx-design) extension, " +"which will allow us to create beautiful, screen-size responsive web-" +"components." +msgstr "" + +#: ../../../docs/intro.md:133 +msgid "First, install `sphinx-design`:" +msgstr "" + +#: ../../../docs/intro.md:139 +msgid "Next, add it to your list of extensions in `conf.py`:" +msgstr "" + +#: ../../../docs/intro.md:148 +msgid "" +"Now, we can use the `design` directive to add a web-component to our " +"Markdown file!" +msgstr "" + +#: ../../../docs/intro.md:169 +msgid "Header" +msgstr "" + +#: ../../../docs/intro.md:168 +msgid "Card Title" +msgstr "" + +#: ../../../docs/intro.md:171 +msgid "Card content" +msgstr "" + +#: ../../../docs/intro.md:173 +msgid "Footer" +msgstr "" + +#: ../../../docs/intro.md +msgid "Label1" +msgstr "" + +#: ../../../docs/intro.md:188 +msgid "Content 1" +msgstr "" + +#: ../../../docs/intro.md +msgid "Label2" +msgstr "" + +#: ../../../docs/intro.md:192 +msgid "Content 2" +msgstr "" + +#: ../../../docs/intro.md:218 +msgid "" +"There are many other great Sphinx extensions that work with MyST, such as" +" the ones used in this documentation:" +msgstr "" + +#: ../../../docs/intro.md:220 +msgid "sphinx-design" +msgstr "" + +#: ../../../docs/intro.md:220 +msgid "Add beautiful, responsive web-components to your documentation" +msgstr "" + +#: ../../../docs/intro.md:221 +msgid "sphinx-copybutton" +msgstr "" + +#: ../../../docs/intro.md:221 +msgid "Add a copy button to your code blocks" +msgstr "" + +#: ../../../docs/intro.md:222 +msgid "sphinxext-rediraffe" +msgstr "" + +#: ../../../docs/intro.md:222 +msgid "Add redirects to your documentation" +msgstr "" + +#: ../../../docs/intro.md:223 +msgid "sphinxext-opengraph" +msgstr "" + +#: ../../../docs/intro.md:223 +msgid "Add OpenGraph metadata to your documentation" +msgstr "" + +#: ../../../docs/intro.md:224 +msgid "sphinx-pyscript" +msgstr "" + +#: ../../../docs/intro.md:224 +msgid "" +"Execute Python code in your documentation, [see here](https://github.com" +"/sphinx-extensions2/sphinx-pyscript)" +msgstr "" + +#: ../../../docs/intro.md:225 +msgid "sphinx-tippy" +msgstr "" + +#: ../../../docs/intro.md:225 +msgid "" +"Add tooltips to your documentation, [see here](https://github.com/sphinx-" +"extensions2/sphinx-tippy)" +msgstr "" + +#: ../../../docs/intro.md:226 +msgid "sphinx-autodoc2" +msgstr "" + +#: ../../../docs/intro.md:226 +msgid "" +"Generate documentation from docstrings, [see here](https://github.com" +"/sphinx-extensions2/sphinx-autodoc2)" +msgstr "" + +#: ../../../docs/intro.md:227 +msgid "sphinx-togglebutton" +msgstr "" + +#: ../../../docs/intro.md:227 +msgid "Add collapsible content to your documentation" +msgstr "" + +#: ../../../docs/intro.md:228 +msgid "sphinxcontrib.mermaid" +msgstr "" + +#: ../../../docs/intro.md:228 +msgid "Generate [Mermaid diagrams](https://mermaid-js.github.io/mermaid/#/)" +msgstr "" + +#: ../../../docs/intro.md:232 +msgid "" +"[sphinx-extensions](https://sphinx-extensions.readthedocs.io/en/latest/)," +" for a curated and opinionated list of Sphinx extensions." +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/live-preview.po b/locales/zh_CN/LC_MESSAGES/live-preview.po new file mode 100644 index 00000000..0d6ae68f --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/live-preview.po @@ -0,0 +1,53 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/live-preview.md:11 +msgid "⚡ Live Preview" +msgstr "" + +#: ../../../docs/live-preview.md:13 +msgid "" +"This is a live preview of the MyST Markdown [docutils " +"renderer](docutils.md). You can edit the text/configuration below and see" +" the live output." +msgstr "" + +#: ../../../docs/live-preview.md +msgid "Input text" +msgstr "" + +#: ../../../docs/live-preview.md +msgid "Configuration (YAML)" +msgstr "" + +#: ../../../docs/live-preview.md +msgid "HTML Render" +msgstr "" + +#: ../../../docs/live-preview.md +msgid "Raw Output" +msgstr "" + +#: ../../../docs/live-preview.md +msgid "Warnings" +msgstr "" + diff --git a/locales/zh_CN/LC_MESSAGES/syntax.po b/locales/zh_CN/LC_MESSAGES/syntax.po new file mode 100644 index 00000000..73126b6e --- /dev/null +++ b/locales/zh_CN/LC_MESSAGES/syntax.po @@ -0,0 +1,5087 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2024, Executable Book Project +# This file is distributed under the same license as the MyST Parser +# package. +# FIRST AUTHOR , 2024. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: MyST Parser 4.0.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2024-12-19 16:17+0800\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: zh_CN\n" +"Language-Team: zh_CN \n" +"Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.16.0\n" + +#: ../../../docs/syntax/admonitions.md:1 +msgid "Admonitions" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:3 +msgid "" +"Admonitions (also known as callouts) highlight a particular block of " +"text, that exists slightly apart from the narrative of your page, such as" +" a note or a warning." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:6 +msgid "" +"Admonitions are a special case of {{directive}} extensions. It is advised" +" to use admonitions with the [colon_fence](#syntax/colon_fence) " +"extension, which signify that the content of the block is also MyST " +"Markdown." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:25 +#: ../../../docs/syntax/admonitions.md:51 +msgid "Let's give readers a helpful hint!" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:17 +msgid "Admonition types" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:19 +msgid "The following core admonition types are available:" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "attention" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:26 +msgid "This is a attention" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "caution" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:32 +msgid "This is a caution" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "danger" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:38 +msgid "This is a danger" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "error" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:44 +msgid "This is a error" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "hint" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:50 +msgid "This is a hint" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "important" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:56 +msgid "This is a important" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "note" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:62 +msgid "This is a note" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "seealso" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:68 +msgid "This is a seealso" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "tip" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:74 +msgid "This is a tip" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "warning" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:80 +msgid "This is a warning" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:24 +msgid "These admonitions take no argument, but may be specified with options:" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:26 +#: ../../../docs/syntax/organising_content.md:29 +msgid "class" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:26 +msgid "" +"A space-separated list of CSS classes to add to the admonition, " +"conforming to the [identifier normalization " +"rules](https://docutils.sourceforge.io/docs/ref/rst/directives.html" +"#identifier-normalization)." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:27 ../../../docs/syntax/optional.md:633 +#: ../../../docs/syntax/organising_content.md:194 +msgid "name" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:27 +#: ../../../docs/syntax/images_and_figures.md:80 +#: ../../../docs/syntax/tables.md:128 ../../../docs/syntax/tables.md:199 +msgid "" +"A reference target for the admonition (see [cross-" +"referencing](#syntax/referencing))." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:54 +msgid "[Reference to my tip](#a-tip-reference)" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:41 +msgid "" +"Sphinx also adds a number of additional admonition types, for denoting " +"changes to the documentation, or to the codebase:" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:67 +msgid "Explanation of the new feature." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:71 +msgid "Explanation of the change." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:75 +msgid "Explanation of the deprecation." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:59 +msgid "Admonition titles" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:61 +msgid "" +"To provide a custom title for an admonition, use the `admonition` " +"directive. If you also want to style the admonition as one of the core " +"admonition types, you can use the `admonition` directive with the `class`" +" option." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:82 +msgid "My custom title with *Markdown*!" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:85 +msgid "This is a custom title for a tip admonition." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:75 +msgid "Collapsible admonitions" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:77 +msgid "" +"The [sphinx-togglebutton](https://sphinx-togglebutton.readthedocs.io) " +"extension allows you to create collapsible admonitions, by adding a " +"`dropdown` class to the admonition." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:101 +msgid "" +"This admonition has been collapsed, meaning you can add longer form " +"content here, without it taking up too much space on the page." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:91 +msgid "Other Containers (grids, tabs, cards, etc.)" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:93 +msgid "" +"Using the [colon_fence](#syntax/colon_fence) extension, content block can" +" be wrapped in containers with a custom CSS class." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:113 +msgid "This is a container with a custom CSS class." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:115 +msgid "It can contain multiple blocks" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:104 +msgid "" +"Using the [sphinx-design](https://github.com/executablebooks/sphinx-" +"design) extension, it is also possible to create beautiful, screen-size " +"responsive web-components." +msgstr "" + +#: ../../../docs/syntax/admonitions.md:126 +msgid "Header" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:125 +msgid "Card Title" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:128 +msgid "Card content" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:130 +msgid "Footer" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "Label1" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:145 +msgid "Content 1" +msgstr "" + +#: ../../../docs/syntax/admonitions.md +msgid "Label2" +msgstr "" + +#: ../../../docs/syntax/admonitions.md:149 +msgid "Content 2" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:2 +msgid "Source code and APIs" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:4 +msgid "Basic block syntax highlighting" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:6 +msgid "" +"Code blocks contain a language identifier, which is used to determine the" +" language of the code. This language is used to determine the syntax " +"highlighting, using an available [pygments " +"lexer](https://pygments.org/docs/lexers/)." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:16 +msgid "Adding a language lexer" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:18 +msgid "" +"You can create and register your own lexer, using the [`pygments.lexers` " +"entry point](https://pygments.org/docs/plugins/#register-plugins), or " +"within a sphinx extension, with the [`app.add_lexer` " +"method](inv:sphinx#*.Sphinx.add_lexer)." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:22 +msgid "Show backticks inside raw markdown blocks" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:26 +msgid "" +"If you'd like to show backticks inside of your markdown, you can do so by" +" nesting them in backticks of a greater length. Markdown will treat the " +"outer-most backticks as the edges of the \"raw\" block and everything " +"inside will show up. For example:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:48 +msgid "`` `hi` ``" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:42 +msgid "Inline syntax highlighting" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:44 +msgid "" +"The [attrs_inline](#syntax/attributes/inline) extension can be used to " +"apply syntax highlighting to inline code:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:57 +msgid "Inline Python code `a = \"b\"`{l=python}" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:50 +msgid "Numbering and highlighting lines" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:52 +msgid "" +"To set a global default for line numbering, per lexer name, the " +"`myst_number_code_blocks` [configuration option](#sphinx/config-options) " +"can be used. For example, using:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:60 +msgid "Will number all code blocks with the `typescript` lexer by default." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:73 +msgid "" +"To apply numbering and highlighting to a specific code block, the " +"[attrs_block](#syntax/attributes/block) extension can be used:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:85 +msgid "Adding a caption" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:87 +msgid "" +"With the `code-block` {{directive}}, a caption can be added to a code " +"blocks, as well as other options:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:109 +msgid "This is a caption" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:102 +#: ../../../docs/syntax/images_and_figures.md:42 +#: ../../../docs/syntax/tables.md:55 ../../../docs/syntax/tables.md:100 +#: ../../../docs/syntax/tables.md:147 +msgid "The following options are recognized:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:104 +msgid "Code block options" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:108 +msgid "`linenos` : flag" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:109 +msgid "Enable to generate line numbers for the code block" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:111 +msgid "`lineno-start` : integer" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:112 +msgid "" +"The starting line number for the code block (`linenos` is automatically " +"enabled)" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:114 +msgid "`emphasize-lines` : comma-separated list of integers" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:115 +msgid "Highlight the specified lines" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:117 +msgid "`caption` : string" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:118 +msgid "The caption for the code block" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:120 +msgid "`force` : flag" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:121 +msgid "Allow minor errors on highlighting to be ignored" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:123 +msgid "`name` : string" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:124 +msgid "" +"The name of the code block, which can be referenced elsewhere in the " +"document" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:126 +msgid "`class` : string" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:127 +msgid "The class to apply to the code block" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:130 +msgid "The [Sphinx documentation](inv:sphinx#code-block)" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:135 +msgid "Including code from files" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:137 +msgid "" +"Longer pieces of code can be included from files using the " +"`literalinclude` {{directive}}:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:144 +msgid "" +"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." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:146 +msgid "" +"To select only a sub-section of the file, the `lines`, `pyobject` or " +"`start-after` and `end-before` options can be used:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:156 +msgid "The [Sphinx documentation](inv:sphinx#literalinclude)" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:160 +msgid "Documenting whole APIs" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:162 +msgid "" +"Sphinx and MyST provide means to analyse source code and automatically " +"generate documentation and referenceable links for APIs." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:164 +msgid "" +"`sphinx.ext.autodoc` can be used ([see below](#syntax/apis/sphinx-" +"autodoc)), however, it is not inherently compatible with MyST Markdown, " +"and so the `sphinx-autodoc2` extension is recommended." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:167 +msgid "`sphinx-autodoc2`" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:169 +msgid "" +"[`sphinx-autodoc2`](https://sphinx-autodoc2.readthedocs.io) is an " +"extension for Sphinx that provides an integrated means to document Python" +" APIs." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:171 +msgid "" +"As opposed to `sphinx.ext.autodoc`, `sphinx-autodoc2` performs static " +"(rather than dynamic) analysis of the source code, integrates full " +"package documenting, and also allows for docstrings to be written in both" +" RestructureText and MyST." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:173 +msgid "" +"The `auto_mode` will automatically generate the full API documentation, " +"as shown ." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:175 +msgid "" +"Alternatively, the `autodoc2-object` directive can be used to generate " +"documentation for a single object. To embed in a MyST document the MyST " +"`render_plugin` should be specified, for example:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:265::1 +#: ../../../myst_parser/sphinx_ext/main.py:198 +#: ../../../myst_parser/sphinx_ext/main.py:217 +#: myst_parser.sphinx_ext.main.setup_sphinx:1 of +msgid "Initialize all settings and transforms in Sphinx." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md ../../../docs/syntax/optional.md +msgid "Parameters" +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:200 +#: myst_parser.sphinx_ext.main.setup_sphinx:3 of +msgid "The Sphinx application object." +msgstr "" + +#: ../../../myst_parser/sphinx_ext/main.py:201 +#: myst_parser.sphinx_ext.main.setup_sphinx:4 of +msgid "Whether to load the parser." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:185 +msgid "" +"This can be referenced elsewhere in the document using the `:py:obj:` " +"role, or a `#` link (see [cross-referencing](#syntax/referencing))." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:199 +msgid "{py:obj}`myst_parser.sphinx_ext.main.setup_sphinx`" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:200 +msgid "[](#myst_parser.sphinx_ext.main.setup_sphinx)" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:192 +msgid "" +"Additionally, summaries of multiple objects can be generated using the " +"`autodoc2-summary` directive:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:215 +msgid "{py:obj}`setup_sphinx `" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:219 +msgid "" +"{py:obj}`create_myst_config " +"`" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:265::1 +#: ../../../myst_parser/sphinx_ext/main.py:221 +msgid "Create the myst config object and add it to the sphinx environment." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:203 +msgid "Using MyST docstrings" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:205 +msgid "" +"`sphinx-autodoc2` can be configured to use MyST docstrings (rather than " +"RestructureText), for the entire project or select objects, by setting " +"the `autodoc2_docstring_parser_regexes` configuration option:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:216 +#: ../../../docs/syntax/roles-and-directives.md:49 +#: ../../../docs/syntax/roles-and-directives.md:238 +#: ../../../docs/syntax/roles-and-directives.md:284 +msgid "For example:" +msgstr "" + +#: ../../../myst_parser/__init__.py:1 +msgid "Initialize the [Sphinx](https://github.com/sphinx-doc/sphinx) extension." +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:229 +msgid "`sphinx.ext.autodoc`" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:231 +msgid "" +"[Sphinx extension `autodoc`](inv:sphinx#sphinx.ext.autodoc) also can " +"generate documentation for Python objects. However, because it is hard-" +"coded to generate RestructureText, the special [`eval-rst` " +"directive](#syntax/directives/parsing) needs to be used:" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:241 +msgid "" +"Summaries can also be generated with " +"[`autosummary`](inv:sphinx#sphinx.ext.autosummary):" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:265::1 +msgid "" +":py:obj:`myst_parser.sphinx_ext.main.setup_sphinx " +"`" +msgstr "" + +#: ../../../docs/syntax/code_and_apis.md:265::1 +msgid "" +":py:obj:`myst_parser.sphinx_ext.main.create_myst_config " +"`" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:2 +msgid "Cross-references" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:4 +msgid "" +"MyST-Parser offers powerful cross-referencing features, to link to URLs, " +"documents, headers, figures and more, that are **portable** across output" +" formats and generate **warnings** when broken." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:7 +msgid "" +"This page covers the basics of setting up referenceable targets for " +"content and how to reference them." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:10 +msgid "Creating explicit targets" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:12 +msgid "" +"Targets are used to define custom anchors that you can refer to elsewhere" +" in your documentation." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:14 +msgid "There are three primary ways to create targets:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:16 +msgid "Annotating a syntax block with `(target)=`" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:17 +msgid "" +"Annotating a syntax block/inline/span with an `{#id}` attribute (using " +"the [attrs_block](#syntax/attributes/block) and " +"[attrs_inline](#syntax/attributes/inline) extensions)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:18 +msgid "Adding a `name` option to a directive" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:49 +#: ../../../docs/syntax/reference.md:110 +msgid "Heading" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:52 +msgid "This is a paragraph, with an `id` attribute." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:54 +msgid "This is a [span with an `id` attribute]{#span-target}." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:59 +msgid "This is a directive with a `name` option" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:62 +msgid "" +"[reference1](#heading-target), [reference2](#paragraph-target), " +"[reference3](#span-target), [reference4](#directive-target)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:41 +msgid "" +"There are also other ways to create targets, specific to certain " +"directives, such as [glossaries](#syntax/glossaries) create targets for " +"terms, and [code APIs](#syntax/apis) create targets for objects:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:67 +msgid "my other term" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:68 +#: ../../../docs/syntax/optional.md:775 ../../../docs/syntax/typography.md:225 +msgid "Definition of the term" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:70 +msgid "[Link to a term](<#my other term>)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:74 +msgid "Docstring content" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:77 +msgid "[Link to a class](#mypackage.MyClass)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:60 +msgid "" +"The [footnotes section](#syntax/footnotes), covers how to create and link" +" to footnotes, and the [sphinxcontrib.bibtex](https://pypi.org/project" +"/sphinxcontrib-bibtex/) extension provides a means to reference " +"bibliographies." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:65 +msgid "Implicit targets" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:67 +msgid "" +"Whole documents can be referenced by path. Headings within documents can " +"also be assigned an implicit target, by setting the " +"`myst_heading_anchors` configuration option. This is should be set to an " +"integer, between 1 and 6, indicating the depth of headings to assign " +"targets to." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:72 +msgid "" +"The anchor \"slugs\" are created according to the [GitHub " +"implementation](https://github.com/Flet/github-slugger): heading titles " +"are lower cased, punctuation is removed, spaces are replaced with `-`, " +"and uniqueness is enforced by suffix enumeration." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:74 +msgid "For example, using `myst_heading_anchors = 2`:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:93 +msgid "A heading with slug" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:95 +msgid "" +"A heading with slug/media/pc/data/lxw/ai/pybook/tests/.temp/MyST-" +"Parser/docs/syntax/cross-referencing.md:95: (INFO/1) Duplicate implicit " +"target name: \"a heading with slug\"." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:97 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:99 +msgid "[Explicit title](#a-heading-with-slug-1)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:86 +msgid "" +"For more information see the [auto-generated header anchors](#syntax" +"/header-anchors) section." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:89 +msgid "" +"In general, it is discouraged to rely on implicit targets, since they are" +" easy to break, if for example a document/heading is moved or renamed." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:93 +msgid "Markdown link syntax" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:95 +msgid "Markdown links come in three forms:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:97 +msgid "" +"*Autolinks* are [URIs][uri] surrounded by `<` and `>`, which must always " +"have a scheme:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:103 +msgid "" +"*Inline links* allow for optional explicit text and titles (in HTML " +"titles are rendered as tooltips):" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:109 +msgid "or, if the destination contains spaces," +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:115 +msgid "" +"*Reference links* define the destination separately in the document, and " +"can be used multiple times:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:125 +msgid "The [CommonMark specification](https://spec.commonmark.org/0.30/#links)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:131 +msgid "Default destination resolution" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:133 +msgid "" +"The destination of a link can resolve to either an **external** target, " +"such as a [URL] to another website, or an **internal** target, such as a " +"file, heading or figure within the same project." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:137 +msgid "" +"By default, MyST will resolve link destinations according to the " +"following rules:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:139 +msgid "" +"Destination beginning with a scheme (e.g. `xxx:`), will be handled " +"according to that scheme:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:142 +msgid "" +"Destinations beginning with `project:` will be treated as internal " +"references" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:143 +msgid "Destinations beginning with `path:` will be treated as downloadable files" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:144 +msgid "" +"Destinations beginning with `inv:` will be treated as intersphinx " +"references" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:145 +msgid "" +"Autolinks or destinations beginning with `http:`, `https:`, `ftp:`, or " +"`mailto:` will be treated as external [URL] links." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:147 +msgid "" +"Destinations which point to a local file path are treated as links to " +"that file." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:150 +msgid "" +"If the destination is a relative path, it is resolved relative to the " +"current file." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:151 +msgid "" +"If the destination is an absolute path (starts with `/`), it is resolved " +"relative to the root of the project (i.e. the source directory)." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:152 +msgid "" +"If that path relates to another document in the project (e.g. a `.md` or " +"`.rst` file), then it will link to the first heading in that document." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:153 +msgid "" +"Links to project documents can also include a `#` fragment identifier, to" +" link to a specific heading in that document." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:154 +msgid "" +"If the path is to a non-source file (e.g. a `.png` or `.pdf` file), then " +"the link will be to the file itself, e.g. to download it." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:156 +msgid "Destinations beginning with `#` will be treated as internal references." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:159 +msgid "First, explicit targets in the same file are searched for, if not found" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:160 +msgid "Then, implicit targets in the same file are searched for, if not found" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:161 +msgid "" +"Then, explicit targets across the whole project are searched for, if not " +"found" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:162 +msgid "Then, intersphinx references are searched for, if not found" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:163 +msgid "A warning is emitted and the destination is left as an external link." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:166 +msgid "" +"Local file path resolution and cross-project references are not available" +" in [single page builds](#myst-docutils)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:169 +msgid "Explicit vs implicit link text" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:171 +msgid "" +"If the link text is explicitly given, e.g. `[text](#dest)`, then the " +"rendered text will be that. This text can contain nested inline markup, " +"such as `[*emphasis*](#syntax/emphasis)`{l=md}." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:174 +msgid "" +"If no text is given or it is an auto-link, e.g. `[](#dest)` or " +"``, then MyST will attempt to resolve an implicit text. " +"For example, if the destination is a heading, then the heading text will " +"be used as the link text, or if the destination is a figure/table then " +"the caption will be used as the link text. Otherwise, the link text will " +"be the destination itself." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:179 +msgid "Examples" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:181 +msgid "Autolinks" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:201 +#: ../../../docs/syntax/cross-referencing.md:214 +#: ../../../docs/syntax/cross-referencing.md:227 +msgid "External URL" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:201 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:202 +#: ../../../docs/syntax/cross-referencing.md:215 +#: ../../../docs/syntax/cross-referencing.md:228 +msgid "Internal target reference" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:202 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:203 +#: ../../../docs/syntax/cross-referencing.md:216 +#: ../../../docs/syntax/cross-referencing.md:229 +msgid "Internal file reference" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:203 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:204 +#: ../../../docs/syntax/cross-referencing.md:217 +#: ../../../docs/syntax/cross-referencing.md:230 +msgid "Internal file -> heading reference" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:204 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:205 +#: ../../../docs/syntax/cross-referencing.md:218 +#: ../../../docs/syntax/cross-referencing.md:231 +msgid "Downloadable file" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:205 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:206 +#: ../../../docs/syntax/cross-referencing.md:219 +#: ../../../docs/syntax/cross-referencing.md:232 +msgid "Intersphinx reference" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:206 +#: ../../../docs/syntax/cross-referencing.md:364 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:194 +msgid "Inline links with implicit text" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:214 +msgid "[](https://example.com)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:215 +msgid "[](#cross-references)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:216 +msgid "[](../intro.md)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:217 +msgid "[](../intro.md#-get-started)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:218 +msgid "[](example.txt)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:219 +msgid "[](inv:sphinx:std#index)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:207 +msgid "Inline links with explicit text" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:227 +msgid "[Explicit text](https://example.com)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:228 +msgid "[Explicit text](#cross-references)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:229 +msgid "[Explicit text](../intro.md)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:230 +msgid "[Explicit text](../intro.md#-get-started)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:231 +msgid "[Explicit text](example.txt)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:232 +msgid "[Explicit text](inv:sphinx:std#index)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:220 +msgid "Customising external URL resolution" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:223 +msgid "" +"`myst_url_schemes` now allows for customising how the links are converted" +" to URLs, and the `attrs_inline` extension can be used to specify certain" +" links as external." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:227 +msgid "" +"By default, all links which begin with `http:`, `https:`, `ftp:`, or " +"`mailto:` will be treated as external [URL] links. You can customise this" +" behaviour in a number of ways using [configuration " +"options](../configuration.md)." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:230 +msgid "" +"Most simply, by setting the `myst_all_links_external` configuration " +"option to `True`, all links will be treated as external [URL] links." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:233 +msgid "" +"To apply selectively to specific links, you can enable the " +"[attrs_inline](syntax/attributes/inline) extension, then add an " +"`external` class to the link.\\ For example, `[my-external-link](my-" +"external-link){.external}` becomes [my-external-link](my-external-" +"link){.external}." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:237 +msgid "" +"To specify a custom list of URL schemes, you can set the " +"`myst_url_schemes` configuration option. By default this is set to " +"`[\"http\", \"https\", \"ftp\", \"mailto\"]`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:240 +msgid "" +"As well as being a list of strings, `myst_url_schemes` can also be a " +"dictionary, where the keys are the URL schemes, and the values define how" +" the links are converted to URLs. This allows you to customise the " +"conversion of links to URLs for specific schemes, for example:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:258 +msgid "Allows for links such as:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:260 +msgid "" +"`[URI](wiki:Uniform_Resource_Identifier#URI_references)` is converted to " +"[URI](wiki:Uniform_Resource_Identifier#URI_references)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:261 +msgid "`` is converted to " +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:262 +msgid "`` is converted to " +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:265 +msgid "" +"You can also use the [sphinx-tippy](https://sphinx-tippy.readthedocs.io) " +"extension to add rich \"hover\" tooltips to links." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:267 +msgid "" +"Adding the `github` class above integrates well the [pydata-sphinx-" +"theme's GitHub link formatting](https://pydata-sphinx-" +"theme.readthedocs.io/en/stable/user_guide/theme-elements.html#link-" +"shortening-for-git-repository-services)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:270 +msgid "The value of each scheme can be:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:272 +msgid "`None`: the link is converted directly to an external URL." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:273 +msgid "" +"A string: the link is converted to an external URL using the string as a " +"template." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:274 +msgid "" +"A dictionary: the link is converted to an external URL using the " +"dictionary’s `url` key as a template." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:275 +msgid "" +"The (optional) `title` key is a template for the link’s implicit title, " +"i.e. it is used if the link has no explicit title." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:276 +msgid "The (optional) `classes` key is a list of classes to add to the link." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:278 +msgid "" +"The templates for `url` and `title` can use variables (enclosed by `{{ " +"}}`), which are substituted for the corresponding parts of the link " +"`:///;?#` (or the full " +"link using `uri`). For example:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:281 +msgid "`scheme`: the URL scheme, e.g. `wiki`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:282 +msgid "`path`: the path part of the URL, e.g. `Uniform_Resource_Identifier`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:283 +msgid "`fragment`: the fragment part of the URL, e.g. `URI_references`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:286 +msgid "Cross-project (intersphinx) links" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:291 +msgid "" +"Each Sphinx HTML build creates a file named `objects.inv` that contains a" +" mapping from referenceable objects to [URIs][uri] relative to the HTML " +"set’s root. Each object is uniquely identified by a `domain`, `type`, and" +" `name`. As well as the relative location, the object can also include " +"implicit `text` for the reference (like the text for a heading)." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:295 +msgid "" +"You can use the `myst-inv` command line tool (installed with " +"`myst_parser`) to visualise and filter any remote URL or local file path " +"to this inventory file (or its parent):" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:315 +msgid "" +"To load external inventories into your Sphinx project, you must load the " +"[`sphinx.ext.intersphinx` extension](inv:sphinx#usage/*/intersphinx), and" +" set the `intersphinx_mapping` configuration option." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:324 +msgid "Docutils configuration" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:328 +msgid "" +"Use the `docutils.conf` configuration file, for more details see [](myst-" +"docutils)." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:337 +msgid "" +"you can then reference inventory objects by prefixing the `inv` schema to" +" the destination [URI]: `inv:key:domain:type#name`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:339 +msgid "" +"`key`, `domain` and `type` are optional, e.g. for `inv:#name`, all " +"inventories, domains and types will be searched, with a [warning emitted" +"](myst-warnings) if multiple matches are found." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:341 +msgid "" +"Additionally, `*` is a wildcard which matches zero or more characters, " +"e.g. `inv:*:std:doc#a*` will match all `std:doc` objects in all " +"inventories, with a `name` beginning with `a`. Note, to match to a " +"literal `*` use `\\*`." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:344 +msgid "Here are some examples:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:350 +msgid "Type" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:351 +#: ../../../docs/syntax/roles-and-directives.md:15 +msgid "Syntax" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:352 +msgid "Rendered" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:354 +msgid "Autolink, full" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:355 +msgid "``{l=myst}" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:356 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:358 +msgid "Link, full" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:359 +msgid "`[Sphinx](inv:sphinx:std:doc#index)`{l=myst}" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:360 +msgid "[Sphinx](inv:sphinx:std:doc#index)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:362 +msgid "Autolink, no type" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:363 +msgid "``{l=myst}" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:366 +msgid "Autolink, no domain" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:367 +msgid "``{l=myst}" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:368 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:370 +msgid "Autolink, only name" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:371 +msgid "``{l=myst}" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:372 +msgid "" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:375 +msgid "Reference roles" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:377 +msgid "" +"Sphinx offers numerous [roles for " +"referencing](#usage/restructuredtext/roles) specific objects." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:379 +msgid "" +"These can also within MyST documents, although it is recommended to use " +"the Markdown syntax where possible, which is more portable and native to " +"MyST." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:410 +msgid "{ref}`syntax/referencing`, {ref}`Explicit text `" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:411 +msgid "{term}`my other term`" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:412 +msgid "{doc}`../intro`, {doc}`Explicit text <../intro>`" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:413 +msgid "{download}`example.txt`, {download}`Explicit text `" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:414 +msgid "" +"{py:class}`mypackage.MyClass`, {py:class}`Explicit text " +"`" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:415 +msgid "" +"{external:class}`sphinx.application.Sphinx`, {external:class}`Explicit " +"text `" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:416 +msgid "" +"{external+sphinx:ref}`code-examples`, {external+sphinx:ref}`Explicit text" +" `" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:420 +msgid ", [][syntax], [Explicit text][syntax]" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:421 +msgid "[](<#my other term>)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:422 +msgid ", [Explicit text](../intro.md)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:423 +msgid ", [Explicit text](example.txt)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:424 +msgid ", [Explicit text](#mypackage.MyClass)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:425 +msgid ", [Explicit text](#sphinx.application.Sphinx)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:426 +msgid ", [Explicit text](inv:sphinx#code-examples)" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:403 +msgid "Handling invalid references" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:405 +msgid "" +"When building your documentation, it is recommended to run in [nitpicky " +"mode](inv:sphinx:std:confval#nitpicky), which will emit warnings for any " +"invalid references." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:407 +msgid "you may encounter warnings such as:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:415 +msgid "" +"To fully suppress a specific warning type, you can use the " +"`suppress_warnings` configuration option, in Sphinx’s `conf.py` file:" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:421 +msgid "or in `docutils.conf` or [command-line tool](../docutils.md):" +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:428 +msgid "" +"In Sphinx specific reference warnings can also be suppressed, using the " +" and " +"configuration options." +msgstr "" + +#: ../../../docs/syntax/cross-referencing.md:434 +msgid "" +"To handle ambiguous references, for intersphinx references see the " +"[](syntax/inv_links) section, or the domains searched for all Markdown " +"references can be restricted globally or per-document using the " +"[`myst_ref_domains` configuration](../configuration.md)." +msgstr "" + +#: ../../../docs/syntax/examples/content_child1.md:3 +msgid "Content child 1" +msgstr "" + +#: ../../../docs/syntax/examples/content_child1.md:5 +#: ../../../docs/syntax/examples/content_child2.md:5 +msgid "Sub heading" +msgstr "" + +#: ../../../docs/syntax/examples/content_child1.md:7 +msgid "Other" +msgstr "" + +#: ../../../docs/syntax/examples/content_child2.md:3 +msgid "Content child 2" +msgstr "" + +#: ../../../docs/syntax/glossary.md:5 +msgid "Glossary" +msgstr "" + +#: ../../../docs/syntax/glossary.md:8 +msgid "Length Units" +msgstr "" + +#: ../../../docs/syntax/glossary.md:10 +msgid "The following length units are supported by the reStructuredText parser:" +msgstr "" + +#: ../../../docs/syntax/glossary.md:13 +msgid "em (em unit, the element's font size)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:14 +msgid "ex (ex unit, x-height of the element’s font)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:15 +msgid "mm (millimeters; 1 mm = 1/1000 m)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:16 +msgid "cm (centimeters; 1 cm = 10 mm)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:17 +msgid "in (inches; 1 in = 2.54 cm = 96 px)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:18 +msgid "px (pixels, 1 px = 1/96 in)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:19 +msgid "pt (points; 1 pt = 1/72 in)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:20 +msgid "pc (picas; 1 pc = 1/6 in = 12 pt)" +msgstr "" + +#: ../../../docs/syntax/glossary.md:22 +msgid "" +"This set corresponds to the length units in [CSS2] (a subset of length " +"units in [CSS3])." +msgstr "" + +#: ../../../docs/syntax/glossary.md:25 +msgid "The following are all valid length values: \"1.5em\", \"20 mm\", \".5in\"." +msgstr "" + +#: ../../../docs/syntax/glossary.md:27 +msgid "" +"Length values without unit are completed with a writer-dependent default " +"(e.g. \"px\" with HTML, \"pt\" with `latex2e`)." +msgstr "" + +#: ../../../docs/syntax/glossary.md:34 +msgid "Percentage Units" +msgstr "" + +#: ../../../docs/syntax/glossary.md:36 +msgid "" +"Percentage values have a percent sign (\"%\") as unit. Percentage values" +" are relative to other values, depending on the context in which they " +"occur." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:1 +msgid "Images and figures" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:3 +msgid "" +"MyST Markdown can be used to include images and figures in your documents" +" as well as referencing those images easily throughout your project." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:5 +msgid "Inline images" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:7 +msgid "The standard Markdown syntax for images is:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:20 +#: ../../../docs/syntax/optional.md:826 +msgid "![fishy](img/fun-fish.png)" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:20 +#: ../../../docs/syntax/images_and_figures.md:28 +#: ../../../docs/syntax/images_and_figures.md:36 +#: ../../../docs/syntax/images_and_figures.md:49 +#: ../../../docs/syntax/images_and_figures.md:141 +#: ../../../docs/syntax/optional.md:368 ../../../docs/syntax/optional.md:602 +#: ../../../docs/syntax/optional.md:826 ../../../docs/syntax/optional.md:840 +#: ../../../docs/syntax/optional.md:857 ../../../docs/syntax/optional.md:899 +#: ../../../docs/syntax/optional.md:907 +msgid "fishy" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:13 +msgid "" +"This will create an **inline** image, which is displayed in the flow of " +"the text." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:15 +msgid "" +"The [attrs_inline](syntax/attributes/inline) extension can be used to add" +" attributes to an inline image:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:28 +msgid "![fishy](img/fun-fish.png){.bg-warning w=100px align=center}" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:21 +msgid "" +"The [html_image](syntax/images/html) extension can also be used, to allow" +" MyST to parse HTML image tags:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:29 +msgid "Block level images" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:31 +msgid "To create a **block** image, use the `image` directive:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:44 +msgid "Image options" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:48 +msgid "``alt`` : text" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:49 +msgid "" +"Alternate text: a short description of the image, displayed by " +"applications that cannot display images, or spoken by applications for " +"visually impaired users." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:53 +msgid "``height`` : [length](units/length)" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:54 +msgid "" +"The desired height of the image. Used to reserve space or scale the image" +" vertically. When the \"scale\" option is also specified, they are " +"combined. For example, a height of 200px and a scale of 50 is equivalent " +"to a height of 100px with no scale." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:59 +msgid "" +"``width`` : [length](units/length) or [percentage](units/percentage) of " +"the current line width" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:60 +msgid "" +"The width of the image. Used to reserve space or scale the image " +"horizontally. As with \"height\" above, when the \"scale\" option is " +"also specified, they are combined." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:64 +msgid "``scale`` : integer percentage (the \"%\" symbol is optional)" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:65 +msgid "" +"The uniform scaling factor of the image. The default is \"100 %\", i.e. " +"no scaling." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:68 +msgid "" +"``align`` : \"top\", \"middle\", \"bottom\", \"left\", \"center\", or " +"\"right\"" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:69 +msgid "" +"The values \"top\", \"middle\", and \"bottom\" control an image's " +"vertical alignment" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:70 +msgid "" +"The values \"left\", \"center\", and \"right\" control an image's " +"horizontal alignment, allowing the image to float and have the text flow " +"around it." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:73 +msgid "``target`` : text (URI or reference name)" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:74 +msgid "Makes the image into a hyperlink reference (\"clickable\")." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:76 +#: ../../../docs/syntax/tables.md:124 ../../../docs/syntax/tables.md:195 +msgid "``class``" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:77 +msgid "A space-separated list of CSS classes to add to the image." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:79 +#: ../../../docs/syntax/tables.md:127 ../../../docs/syntax/tables.md:198 +msgid "``name``" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:83 +msgid "Figures (images with captions)" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:85 +msgid "To create a **figure**, use the `figure` directive:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:112 +msgid "map to buried treasure" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:117 +msgid "This is the caption of the figure (a simple paragraph)." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:119 +msgid "" +"The legend consists of all elements after the caption. In this case, the" +" legend consists of this paragraph and the following table:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:105 +msgid "" +"The \"figure\" directive supports all of the options of the \"image\" " +"directive, as well as the following:" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:107 +msgid "Figure options" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:111 +msgid "" +"figwidth : \"image\", [length](units/length) or " +"[percentage](units/percentage) of current line width" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:112 +msgid "" +"The width of the figure. If the value is \"image\", the width of the " +"image is used. Otherwise, the value is interpreted as a length or " +"percentage of the current line width." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:116 +msgid "figclass : text" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:117 +msgid "" +"A space-separated list of CSS classes to add to the figure (`class` are " +"added to the image)." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:122 +msgid "" +"See the section for information on how to " +"create figures that use native Markdown images." +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:143 +msgid "This is a caption in __*Markdown*__" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:134 +msgid "Figures with multiple images" +msgstr "" + +#: ../../../docs/syntax/images_and_figures.md:136 +msgid "" +"See the [sphinx-subfigure](https://sphinx-subfigure.readthedocs.io) " +"extension for a way to create figures with multiple images." +msgstr "" + +#: ../../../docs/syntax/math.md:1 +msgid "Math and equations" +msgstr "" + +#: ../../../docs/syntax/math.md:3 +msgid "" +"Math can be written in the common LaTeX markup. There are several " +"syntaxes to define inline and block math, depending on your preference." +msgstr "" + +#: ../../../docs/syntax/math.md:7 +msgid "Math role and directive" +msgstr "" + +#: ../../../docs/syntax/math.md:9 +msgid "" +"The `math` {{role}} and {{directive}} are used to define inline and block" +" math respectively." +msgstr "" + +#: ../../../docs/syntax/math.md:11 +msgid "" +"The directive supports multiple equations, which should be separated by a" +" blank line. Each single equation can have multiple aligned lines, which " +"should be separated by `\\\\` characters, and each line can have multiple" +" `&` characters to align the equations." +msgstr "" + +#: ../../../docs/syntax/math.md:14 +msgid "" +"The `label` option can also be used to reference the equation later on, " +"with the `eq` role." +msgstr "" + +#: ../../../docs/syntax/math.md:38 +msgid "Since Pythagoras, we know that {math}`a^2 + b^2 = c^2`." +msgstr "" + +#: ../../../docs/syntax/math.md:40 +msgid "" +"(a + b)^2 = a^2 + 2ab + b^2\n" +"\n" +"(a + b)^2 &= (a + b)(a + b) \\\\\n" +" &= a^2 + 2ab + b^2" +msgstr "" + +#: ../../../docs/syntax/math.md:48 +msgid "The equation {eq}`mymath` is a quadratic equation." +msgstr "" + +#: ../../../docs/syntax/math.md:33 +msgid "" +"Sphinx documentation on the [role](inv:sphinx:rst:role#math) and " +"[directive](inv:sphinx:rst:directive#math), and [math support for HTML " +"outputs in Sphinx](inv:sphinx#math-support)." +msgstr "" + +#: ../../../docs/syntax/math.md:37 ../../../docs/syntax/optional.md:113 +msgid "Dollar delimited math" +msgstr "" + +#: ../../../docs/syntax/math.md:39 +msgid "" +"Enabling the [dollarmath](#syntax/math/dollar) extension will allow " +"parsing the following syntax:" +msgstr "" + +#: ../../../docs/syntax/math.md:41 ../../../docs/syntax/optional.md:117 +msgid "Inline math: `$...$`" +msgstr "" + +#: ../../../docs/syntax/math.md:42 ../../../docs/syntax/optional.md:118 +msgid "Display (block) math: `$$...$$`" +msgstr "" + +#: ../../../docs/syntax/math.md:44 ../../../docs/syntax/optional.md:120 +msgid "Additionally if `myst_dmath_allow_labels=True` is set (the default):" +msgstr "" + +#: ../../../docs/syntax/math.md:46 ../../../docs/syntax/optional.md:122 +msgid "Display (block) math with equation label: `$$...$$ (1)`" +msgstr "" + +#: ../../../docs/syntax/math.md:67 +msgid "" +"\n" +"(a + b)^2 &= (a + b)(a + b) \\\\\n" +" &= a^2 + 2ab + b^2\n" +msgstr "" + +#: ../../../docs/syntax/math.md:72 +msgid "The equation {eq}`mymath2` is also a quadratic equation." +msgstr "" + +#: ../../../docs/syntax/math.md:61 ../../../docs/syntax/optional.md:131 +msgid "Escaping Dollars" +msgstr "" + +#: ../../../docs/syntax/math.md:64 ../../../docs/syntax/optional.md:134 +msgid "" +"Math can be escaped (negated) by adding a `\\` before the first symbol, " +"e.g. `\\$a$` renders as \\$a\\$. Escaping can also be used inside math, " +"e.g. `$a=\\$3$` renders as $a=\\$3$." +msgstr "" + +#: ../../../docs/syntax/math.md:67 ../../../docs/syntax/optional.md:137 +msgid "" +"Conversely `\\\\` will negate the escaping, so `\\\\$a$` renders as " +"\\\\$a$." +msgstr "" + +#: ../../../docs/syntax/math.md:70 ../../../docs/syntax/optional.md:215 +msgid "Direct LaTeX Math" +msgstr "" + +#: ../../../docs/syntax/math.md:72 +msgid "" +"Enabling the [amsmath](#syntax/amsmath) extension will directly parse the" +" following top-level math environments:" +msgstr "" + +#: ../../../docs/syntax/math.md:74 ../../../docs/syntax/optional.md:221 +msgid "" +"equation, multiline, gather, align, alignat, flalign, matrix, pmatrix, " +"bmatrix, Bmatrix, vmatrix, Vmatrix, eqnarray." +msgstr "" + +#: ../../../docs/syntax/math.md:76 ../../../docs/syntax/optional.md:223 +msgid "As expected, environments ending in `*` will not be numbered, for example:" +msgstr "" + +#: ../../../docs/syntax/math.md:102 ../../../docs/syntax/optional.md:249 +msgid "" +"\\begin{gather*}\n" +"a_1=b_1+c_1\\\\\n" +"a_2=b_2+c_2-d_2+e_2\n" +"\\end{gather*}" +msgstr "" + +#: ../../../docs/syntax/math.md:107 ../../../docs/syntax/optional.md:254 +msgid "" +"\\begin{align}\n" +"a_{11}& =b_{11}&\n" +" a_{12}& =b_{12}\\\\\n" +"a_{21}& =b_{21}&\n" +" a_{22}& =b_{22}+c_{22}\n" +"\\end{align}" +msgstr "" + +#: ../../../docs/syntax/optional.md:21 +msgid "Syntax Extensions" +msgstr "" + +#: ../../../docs/syntax/optional.md:23 +msgid "" +"MyST-Parser is highly configurable, utilising the inherent " +"\"plugability\" of the [markdown-it-py](inv:markdown_it#index) parser. " +"The following syntaxes are optional (disabled by default) and can be " +"enabled *via* the {{ confpy }} (see also [](sphinx/config-options)). " +"Their goal is generally to add more *Markdown friendly* syntaxes; often " +"enabling and rendering [markdown-it-py " +"plugins](inv:markdown_it#md/plugins) that extend the [CommonMark " +"specification](https://commonmark.org/)." +msgstr "" + +#: ../../../docs/syntax/optional.md:27 +msgid "To enable all the syntaxes explained below:" +msgstr "" + +#: ../../../docs/syntax/optional.md:49 +msgid "" +"`myst_enable_extensions` replaces previous configuration options: " +"`admonition_enable`, `figure_enable`, `dmath_enable`, `amsmath_enable`, " +"`deflist_enable`, `html_img_enable`" +msgstr "" + +#: ../../../docs/syntax/optional.md:57 ../../../docs/syntax/typography.md:3 +msgid "Typography" +msgstr "" + +#: ../../../docs/syntax/optional.md:59 +msgid "" +"Adding `\"smartquotes\"` to `myst_enable_extensions` (in the {{ confpy " +"}}) will automatically convert standard quotations to their " +"opening/closing variants:" +msgstr "" + +#: ../../../docs/syntax/optional.md:61 +msgid "`'single quotes'`: 'single quotes'" +msgstr "" + +#: ../../../docs/syntax/optional.md:62 +msgid "`\"double quotes\"`: \"double quotes\"" +msgstr "" + +#: ../../../docs/syntax/optional.md:64 +msgid "" +"Adding `\"replacements\"` to `myst_enable_extensions` (in the {{ confpy " +"}}) will automatically convert some common typographic texts:" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "text" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "converted" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``(c)``, ``(C)``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "(c)" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``(tm)``, ``(TM)``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "(tm)" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``(r)``, ``(R)``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "(r)" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``(p)``, ``(P)``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "(p)" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``+-``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "+-" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``...``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "..." +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``?....``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "?...." +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``!....``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "!...." +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``????????``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "????????" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``!!!!!``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "!!!!!" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``,,,``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid ",,," +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``--``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "--" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "``---``" +msgstr "" + +#: ../../../docs/syntax/optional.md:48 +msgid "---" +msgstr "" + +#: ../../../docs/syntax/optional.md:84 +msgid "Strikethrough" +msgstr "" + +#: ../../../docs/syntax/optional.md:89 +msgid "" +"The `strikethrough` extension allows text within `~~` delimiters to have " +"a strikethrough (horizontal line) placed over it. For example, " +"`~~strikethrough with *emphasis*~~` renders as: ~~strikethrough with " +"*emphasis*~~." +msgstr "" + +#: ../../../docs/syntax/optional.md:93 +msgid "" +"This extension is currently only supported for HTML output, and you will " +"need to suppress the `myst.strikethrough` warning (see [](myst-warnings))" +msgstr "" + +#: ../../../docs/syntax/optional.md:99 +msgid "Math shortcuts" +msgstr "" + +#: ../../../docs/syntax/optional.md:101 +msgid "" +"Math is parsed by adding to the `myst_enable_extensions` list option, in " +"the {{ confpy }} one or both of:" +msgstr "" + +#: ../../../docs/syntax/optional.md:103 +msgid "`\"dollarmath\"` for parsing of dollar `$` and `$$` encapsulated math." +msgstr "" + +#: ../../../docs/syntax/optional.md:104 +msgid "" +"`\"amsmath\"` for direct parsing of [amsmath LaTeX " +"environments](https://ctan.org/pkg/amsmath)." +msgstr "" + +#: ../../../docs/syntax/optional.md:106 +msgid "" +"These options enable their respective Markdown parser plugins, as " +"detailed in the [markdown-it plugin guide](inv:markdown_it#md/plugins)." +msgstr "" + +#: ../../../docs/syntax/optional.md:109 +msgid "" +"`myst_dmath_enable=True` and `myst_amsmath_enable=True` are deprecated, " +"and replaced by `myst_enable_extensions = [\"dollarmath\", \"amsmath\"]`" +msgstr "" + +#: ../../../docs/syntax/optional.md:115 +msgid "Enabling `dollarmath` will parse the following syntax:" +msgstr "" + +#: ../../../docs/syntax/optional.md:124 +msgid "" +"For example, `$x_{hey}=it+is^{math}$` renders as $x_{hey}=it+is^{math}$. " +"This is equivalent to writing:" +msgstr "" + +#: ../../../docs/syntax/optional.md:140 +msgid "" +"Block-level math can be specified with `$$` signs that wrap the math " +"block you'd like to parse. For example:" +msgstr "" + +#: ../../../docs/syntax/optional.md:159 +msgid "" +"\n" +" y & = ax^2 + bx + c \\\\\n" +" f(x) & = x^2 + 2xy + y^2\n" +msgstr "" + +#: ../../../docs/syntax/optional.md:152 +msgid "This is equivalent to the following directive:" +msgstr "" + +#: ../../../docs/syntax/optional.md:170 +msgid "" +" y & = ax^2 + bx + c \\\\\n" +" f(x) & = x^2 + 2xy + y^2" +msgstr "" + +#: ../../../docs/syntax/optional.md:163 +msgid "You can also add labels to block equations:" +msgstr "" + +#: ../../../docs/syntax/optional.md:182 +msgid "" +"\n" +"e = mc^2\n" +msgstr "" + +#: ../../../docs/syntax/optional.md:186 +msgid "This is the best equation {eq}`eqn:best`" +msgstr "" + +#: ../../../docs/syntax/optional.md:175 +msgid "There are a few other options available to control dollar math parsing:" +msgstr "" + +#: ../../../docs/syntax/optional.md:177 +msgid "" +"`myst_dmath_allow_space=False`, will cause inline math to only be parsed " +"if there are no initial / final spaces, e.g. `$a$` but not `$ a$` or `$a " +"$`." +msgstr "" + +#: ../../../docs/syntax/optional.md:179 +msgid "" +"`myst_dmath_allow_digits=False`, will cause inline math to only be parsed" +" if there are no initial / final digits, e.g. `$a$` but not `1$a$` or " +"`$a$2`." +msgstr "" + +#: ../../../docs/syntax/optional.md:181 +msgid "" +"These options can both be useful if you also wish to use `$` as a unit of" +" currency." +msgstr "" + +#: ../../../docs/syntax/optional.md:184 +msgid "`myst_dmath_double_inline` option" +msgstr "" + +#: ../../../docs/syntax/optional.md:187 +msgid "" +"To allow display math (i.e. `$$`) within an inline context, set " +"`myst_dmath_double_inline = True` (`False` by default). This allows for " +"example:" +msgstr "" + +#: ../../../docs/syntax/optional.md:207 +msgid "" +"Hence, for $\\alpha \\in (0, 1)$, $$ \\mathbb P (\\alpha \\bar{X} \\ge " +"\\mu) \\le \\alpha; $$ i.e., $[\\alpha \\bar{X}, \\infty)$ is a lower " +"1-sided $1-\\alpha$ confidence bound for $\\mu$." +msgstr "" + +#: ../../../docs/syntax/optional.md:207 +msgid "" +"\n" +" \\mathbb P (\\alpha \\bar{X} \\ge \\mu) \\le \\alpha;\n" +msgstr "" + +#: ../../../docs/syntax/optional.md:200 +msgid "Math in other block elements" +msgstr "" + +#: ../../../docs/syntax/optional.md:202 +msgid "" +"Math will also work when nested in other block elements, like lists or " +"quotes:" +msgstr "" + +#: ../../../docs/syntax/optional.md:220 ../../../docs/syntax/optional.md:270 +msgid "A list" +msgstr "" + +#: ../../../docs/syntax/optional.md:221 ../../../docs/syntax/optional.md:223 +msgid " a = 1 " +msgstr "" + +#: ../../../docs/syntax/optional.md:223 +msgid "A block quote $$ a = 1 $$" +msgstr "" + +#: ../../../docs/syntax/optional.md:217 +msgid "" +"By adding `\"amsmath\"` to `myst_enable_extensions` (in the {{ confpy " +"}}), you can enable direct parsing of " +"[amsmath](https://ctan.org/pkg/amsmath) LaTeX equations. These top-level " +"math environments will then be directly parsed:" +msgstr "" + +#: ../../../docs/syntax/optional.md:243 +msgid "" +"`\\labels` inside the environment are not currently identified, and so " +"cannot be referenced. We hope to implement this in a future update (see " +"[executablebooks/MyST-Parser#202](https://github.com/executablebooks" +"/MyST-Parser/issues/202))!" +msgstr "" + +#: ../../../docs/syntax/optional.md:247 +msgid "" +"This syntax will also work when nested in other block elements, like " +"lists or quotes:" +msgstr "" + +#: ../../../docs/syntax/optional.md:271 +msgid "" +"\\begin{gather*}\n" +"a_1=b_1+c_1\\\\a_2=b_2+c_2-d_2+e_2\n" +"\\end{gather*}" +msgstr "" + +#: ../../../docs/syntax/optional.md:275 +msgid "A block quote" +msgstr "" + +#: ../../../docs/syntax/optional.md:276 +msgid "" +"\\begin{gather*}\n" +" a_1=b_1+c_1\\\\a_2=b_2+c_2-d_2+e_2\n" +" \\end{gather*}" +msgstr "" + +#: ../../../docs/syntax/optional.md:264 +msgid "Mathjax and math parsing" +msgstr "" + +#: ../../../docs/syntax/optional.md:266 +msgid "" +"When building HTML using the extension " +"(enabled by default), If `dollarmath` is enabled, Myst-Parser injects the" +" `tex2jax_ignore` (MathJax v2) and `mathjax_ignore` (MathJax v3) classes" +" in to the top-level section of each MyST document, and adds the " +"following default MathJax configuration:" +msgstr "" + +#: ../../../docs/syntax/optional.md:269 +msgid "" +"MathJax version 2 (see [the tex2jax " +"preprocessor](https://docs.mathjax.org/en/v2.7-latest/options/preprocessors/tex2jax.html" +"#configure-tex2jax):" +msgstr "" + +#: ../../../docs/syntax/optional.md:275 +msgid "" +"MathJax version 3 (see [the document " +"options](https://docs.mathjax.org/en/latest/options/document.html?highlight=ignoreHtmlClass" +"#the-configuration-block)):" +msgstr "" + +#: ../../../docs/syntax/optional.md:281 +msgid "" +"This ensures that MathJax processes only math, identified by the " +"`dollarmath` and `amsmath` extensions, or specified in `math` directives." +msgstr "" + +#: ../../../docs/syntax/optional.md:283 +msgid "" +"To change this behaviour, set a custom regex, for identifying HTML " +"classes to process, like `myst_mathjax_classes=\"math|myclass\"`, or set " +"`myst_update_mathjax=False` to inhibit this override and process all HTML" +" elements." +msgstr "" + +#: ../../../docs/syntax/optional.md:286 +msgid "Linkify" +msgstr "" + +#: ../../../docs/syntax/optional.md:288 +msgid "" +"Adding `\"linkify\"` to `myst_enable_extensions` (in the {{ confpy }}) " +"will automatically identify \"bare\" web URLs and add hyperlinks:" +msgstr "" + +#: ../../../docs/syntax/optional.md:290 +msgid "`www.example.com` -> www.example.com" +msgstr "" + +#: ../../../docs/syntax/optional.md:292 +msgid "" +"To only match URLs that start with schema, such as `http://example.com`, " +"set `myst_linkify_fuzzy_links=False`." +msgstr "" + +#: ../../../docs/syntax/optional.md:295 +msgid "" +"This extension requires that [linkify-it-py](https://github.com/tsutsu3" +"/linkify-it-py) is installed. Either directly; `pip install linkify-it-" +"py` or *via* `pip install myst-parser[linkify]`." +msgstr "" + +#: ../../../docs/syntax/optional.md:301 +msgid "Substitutions (with Jinja2)" +msgstr "" + +#: ../../../docs/syntax/optional.md:303 +msgid "" +"Adding `\"substitution\"` to `myst_enable_extensions` (in the {{ confpy " +"}}) will allow you to add substitutions, added in either the `conf.py` " +"using `myst_substitutions`:" +msgstr "" + +#: ../../../docs/syntax/optional.md:311 +msgid "" +"or at the top of the file, in the front-matter section (see [this " +"section](syntax/frontmatter)):" +msgstr "" + +#: ../../../docs/syntax/optional.md:332 +msgid "Keys in the front-matter will override ones in the `conf.py`." +msgstr "" + +#: ../../../docs/syntax/optional.md:335 +msgid "" +"You can use these substitutions inline or as blocks, and you can even " +"nest substitutions in other substitutions (but circular references are " +"prohibited):" +msgstr "" + +#: ../../../docs/syntax/optional.md:359 +msgid "Inline: {{ key1 }}" +msgstr "" + +#: ../../../docs/syntax/optional.md:361 +msgid "Block level:" +msgstr "" + +#: ../../../docs/syntax/optional.md:366 ../../../docs/syntax/optional.md:370 +msgid "I'm a **substitution**" +msgstr "" + +#: ../../../docs/syntax/optional.md:354 +msgid "" +"Substitutions will only be assessed where you would normally use " +"Markdown, e.g. not in code blocks:" +msgstr "" + +#: ../../../docs/syntax/optional.md:363 +msgid "" +"One should also be wary of using unsuitable directives for inline " +"substitutions. This may lead to unexpected outcomes." +msgstr "" + +#: ../../../docs/syntax/optional.md:368 +msgid "" +"Substitution references are assessed as [Jinja2 " +"expressions](http://jinja.palletsprojects.com) which can use " +"[filters](https://jinja.palletsprojects.com/en/2.11.x/templates/#list-of-" +"builtin-filters), and also contains the [Sphinx " +"Environment](inv:sphinx#extdev/envapi) in the context (as `env`). " +"Therefore you can do things like:" +msgstr "" + +#: ../../../docs/syntax/optional.md:385 +msgid "version: {{ env.config.version }}" +msgstr "" + +#: ../../../docs/syntax/optional.md:386 +msgid "docname: {{ env.docname | upper }}" +msgstr "" + +#: ../../../docs/syntax/optional.md:388 +msgid "ab" +msgstr "" + +#: ../../../docs/syntax/optional.md:377 +msgid "" +"You can also change the delimiter if necessary, for example setting in " +"the `conf.py`:" +msgstr "" + +#: ../../../docs/syntax/optional.md:383 +msgid "" +"Will parse: `|| \"a\" + \"b\" ||`. This should be changed with care " +"though, so as not to affect other syntaxes." +msgstr "" + +#: ../../../docs/syntax/optional.md:386 +msgid "The exact logic for handling substitutions is:" +msgstr "" + +#: ../../../docs/syntax/optional.md:388 +msgid "" +"Combine global substitutions (specified in `conf.py`) with front-matter " +"substitutions, to create a variable context (front-matter takes priority)" +msgstr "" + +#: ../../../docs/syntax/optional.md:389 +msgid "Add the sphinx `env` to the variable context" +msgstr "" + +#: ../../../docs/syntax/optional.md:390 +msgid "" +"Create the string content to render using Jinja2 (passing it the variable" +" context)" +msgstr "" + +#: ../../../docs/syntax/optional.md:391 +msgid "" +"If the substitution is inline and not a directive, render ignoring block " +"syntaxes (like lists or block-quotes), otherwise render with all syntax " +"rules." +msgstr "" + +#: ../../../docs/syntax/optional.md:393 +msgid "Substitutions and URLs" +msgstr "" + +#: ../../../docs/syntax/optional.md:395 +msgid "" +"Substitutions cannot be directly used in URLs, such as `[a " +"link](https://{{key4}}.com)` or ``. However, since " +"Jinja2 substitutions allow for Python methods to be used, you can use " +"string formatting or replacements:" +msgstr "" + +#: ../../../docs/syntax/optional.md:413 +msgid "[a link](https://example.com)" +msgstr "" + +#: ../../../docs/syntax/optional.md:415 +msgid "" +msgstr "" + +#: ../../../docs/syntax/optional.md:407 +msgid "Code fences using colons" +msgstr "" + +#: ../../../docs/syntax/optional.md:409 +msgid "" +"By adding `\"colon_fence\"` to `myst_enable_extensions` (in the {{ confpy" +" }}), you can also use `:::` delimiters to denote directives, instead of " +"```` ``` ````." +msgstr "" + +#: ../../../docs/syntax/optional.md:412 +msgid "" +"Using colons instead of back-ticks has the benefit of allowing the " +"content to be rendered correctly, when you are working in any standard " +"Markdown editor. It is ideal for admonition type directives (as " +"documented in [Directives](syntax/directives)) or tables with titles, for" +" example:" +msgstr "" + +#: ../../../docs/syntax/optional.md:440 ../../../docs/syntax/optional.md:454 +#: ../../../docs/syntax/optional.md:466 +msgid "This text is **standard** _Markdown_" +msgstr "" + +#: ../../../docs/syntax/optional.md:443 +msgid "This is a **standard** _Markdown_ title" +msgstr "" + +#: ../../../docs/syntax/optional.md:432 +msgid "Similar to normal directives, these directives can also be nested:" +msgstr "" + +#: ../../../docs/syntax/optional.md:444 +msgid "and also parameter options can be used:" +msgstr "" + +#: ../../../docs/syntax/optional.md:463 +msgid "This *is* also **Markdown**" +msgstr "" + +#: ../../../docs/syntax/optional.md:458 +msgid "Admonition directives" +msgstr "" + +#: ../../../docs/syntax/optional.md:461 +msgid "" +"`myst_admonition_enable` is deprecated and replaced by " +"`myst_enable_extensions = [\"colon_fence\"]` (see above). Also, classes " +"should now be set with the `:class: myclass` option." +msgstr "" + +#: ../../../docs/syntax/optional.md:464 +msgid "Also see [](syntax/html-admonition)." +msgstr "" + +#: ../../../docs/syntax/optional.md:469 +msgid "Auto-generated header anchors" +msgstr "" + +#: ../../../docs/syntax/optional.md:471 +msgid "" +"The MyST Parser can automatically generate label \"slugs\" for header " +"anchors so that you can reference them from markdown links. For example, " +"you can use header bookmark links, locally; `[](#header-anchor)`, or " +"cross-file `[](path/to/file.md#header-anchor)`. To achieve this, use the " +"`myst_heading_anchors = DEPTH` configuration option, where `DEPTH` is the" +" depth of header levels for which you wish to generate links." +msgstr "" + +#: ../../../docs/syntax/optional.md:475 +msgid "" +"For example, the following configuration in `conf.py` tells the " +"`myst_parser` to generate labels for heading anchors for `h1`, `h2`, and " +"`h3` level headings (corresponding to `#`, `##`, and `###` in markdown)." +msgstr "" + +#: ../../../docs/syntax/optional.md:481 +msgid "" +"You can then insert markdown links directly to anchors that are generated" +" from your header titles in your documentation:" +msgstr "" + +#: ../../../docs/syntax/optional.md:494 +msgid "[](#auto-generated-header-anchors)" +msgstr "" + +#: ../../../docs/syntax/optional.md:487 +msgid "The paths to other files should be relative to the current file:" +msgstr "" + +#: ../../../docs/syntax/optional.md:500 +msgid "[**link text**](./typography.md#headings)" +msgstr "" + +#: ../../../docs/syntax/optional.md:493 +msgid "Anchor slug structure" +msgstr "" + +#: ../../../docs/syntax/optional.md:495 +msgid "" +"The anchor \"slugs\" created aim to follow the [GitHub " +"implementation](https://github.com/Flet/github-slugger):" +msgstr "" + +#: ../../../docs/syntax/optional.md:497 +msgid "lower-case text" +msgstr "" + +#: ../../../docs/syntax/optional.md:498 +msgid "remove punctuation" +msgstr "" + +#: ../../../docs/syntax/optional.md:499 +msgid "replace spaces with `-`" +msgstr "" + +#: ../../../docs/syntax/optional.md:500 +msgid "enforce uniqueness *via* suffix enumeration `-1`" +msgstr "" + +#: ../../../docs/syntax/optional.md:502 +msgid "" +"To change the slug generation function, set `myst_heading_slug_func` in " +"your `conf.py` to a function that accepts a string and returns a string." +msgstr "" + +#: ../../../docs/syntax/optional.md:505 +msgid "" +"`myst_heading_slug_func` can now also be set to a string, which will be " +"interpreted as an import path to a function, e.g. `myst_heading_slug_func" +" = \"mypackage.mymodule.slugify\"`." +msgstr "" + +#: ../../../docs/syntax/optional.md:510 +msgid "Inspect the links that will be created" +msgstr "" + +#: ../../../docs/syntax/optional.md:512 +msgid "" +"You can inspect the links that will be created using the command-line " +"tool:" +msgstr "" + +#: ../../../docs/syntax/optional.md:527 +msgid "Definition Lists" +msgstr "" + +#: ../../../docs/syntax/optional.md:529 +msgid "" +"By adding `\"deflist\"` to `myst_enable_extensions` (in the {{ confpy " +"}}), you will be able to utilise definition lists. Definition lists " +"utilise the [markdown-it-py deflist plugin](inv:markdown_it#md/plugins), " +"which itself is based on the [Pandoc definition list " +"specification](http://johnmacfarlane.net/pandoc/README.html#definition-" +"lists)." +msgstr "" + +#: ../../../docs/syntax/optional.md:533 +msgid "" +"This syntax can be useful, for example, as an alternative to nested " +"bullet-lists:" +msgstr "" + +#: ../../../docs/syntax/optional.md:549 ../../../docs/syntax/optional.md:559 +#: ../../../docs/syntax/typography.md:212 +msgid "Term 1" +msgstr "" + +#: ../../../docs/syntax/optional.md:550 ../../../docs/syntax/optional.md:552 +#: ../../../docs/syntax/optional.md:560 ../../../docs/syntax/optional.md:563 +#: ../../../docs/syntax/typography.md:213 +msgid "Definition" +msgstr "" + +#: ../../../docs/syntax/optional.md:551 ../../../docs/syntax/optional.md:562 +#: ../../../docs/syntax/optional.md:593 ../../../docs/syntax/typography.md:215 +msgid "Term 2" +msgstr "" + +#: ../../../docs/syntax/optional.md:542 +msgid "Using instead:" +msgstr "" + +#: ../../../docs/syntax/optional.md:552 +msgid "From the Pandoc documentation:" +msgstr "" + +#: ../../../docs/syntax/optional.md:554 +msgid "" +"Each term must fit on one line, which may optionally be followed by a " +"blank line, and must be followed by one or more definitions. A definition" +" begins with a colon or tilde, which may be indented one or two spaces." +msgstr "" + +#: ../../../docs/syntax/optional.md:557 +msgid "" +"A term may have multiple definitions, and each definition may consist of " +"one or more block elements (paragraph, code block, list, etc.)" +msgstr "" + +#: ../../../docs/syntax/optional.md:559 +msgid "Here is a more complex example, demonstrating some of these features:" +msgstr "" + +#: ../../../docs/syntax/optional.md:587 +msgid "Term *with Markdown*" +msgstr "" + +#: ../../../docs/syntax/optional.md:588 +msgid "Definition [with reference](syntax/definition-lists)" +msgstr "" + +#: ../../../docs/syntax/optional.md:590 +msgid "A second paragraph" +msgstr "" + +#: ../../../docs/syntax/optional.md:591 +msgid "A second definition" +msgstr "" + +#: ../../../docs/syntax/optional.md:594 +msgid "Definition 2a" +msgstr "" + +#: ../../../docs/syntax/optional.md:595 +msgid "Definition 2b" +msgstr "" + +#: ../../../docs/syntax/optional.md:597 +msgid "Term 3" +msgstr "" + +#: ../../../docs/syntax/optional.md:599 +msgid "A quote" +msgstr "" + +#: ../../../docs/syntax/optional.md:600 +msgid "A final definition, that can even include images:" +msgstr "" + +#: ../../../docs/syntax/optional.md:581 +msgid "Task Lists" +msgstr "" + +#: ../../../docs/syntax/optional.md:583 +msgid "" +"By adding `\"tasklist\"` to `myst_enable_extensions` (in the {{ confpy " +"}}), you will be able to utilise task lists. Task lists utilise the " +"[markdown-it-py tasklists plugin](inv:markdown_it#md/plugins), and are " +"applied to markdown list items starting with `[ ]` or `[x]`:" +msgstr "" + +#: ../../../docs/syntax/optional.md:600 ../../../docs/syntax/typography.md:167 +msgid "An item that needs doing" +msgstr "" + +#: ../../../docs/syntax/optional.md:601 ../../../docs/syntax/typography.md:168 +msgid "An item that is complete" +msgstr "" + +#: ../../../docs/syntax/optional.md:594 +msgid "Field Lists" +msgstr "" + +#: ../../../docs/syntax/optional.md:599 +msgid "" +"By adding `\"fieldlist\"` to `myst_enable_extensions` (in the {{ confpy " +"}}), you will be able to utilise field lists. Field lists are mappings " +"from field names to field bodies, based on the [reStructureText " +"syntax](https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html" +"#field-lists)." +msgstr "" + +#: ../../../docs/syntax/optional.md:632 +msgid "name only" +msgstr "" + +#: ../../../docs/syntax/optional.md:633 +msgid "body" +msgstr "" + +#: ../../../docs/syntax/optional.md:634 +msgid "Nested syntax" +msgstr "" + +#: ../../../docs/syntax/optional.md:634 +msgid "Both name and body may contain **nested syntax**." +msgstr "" + +#: ../../../docs/syntax/optional.md:635 ../../../docs/syntax/typography.md:32 +msgid "Paragraphs" +msgstr "" + +#: ../../../docs/syntax/optional.md:635 +msgid "" +"Since the field marker may be quite long, the second and subsequent lines" +" of a paragraph do not have to line up with the first line." +msgstr "" + +#: ../../../docs/syntax/optional.md:638 +msgid "Blocks" +msgstr "" + +#: ../../../docs/syntax/optional.md:640 +msgid "As well as paragraphs, any block syntaxes may be used in a field body:" +msgstr "" + +#: ../../../docs/syntax/optional.md:642 +msgid "Me" +msgstr "" + +#: ../../../docs/syntax/optional.md:643 +msgid "Myself" +msgstr "" + +#: ../../../docs/syntax/optional.md:644 +msgid "I" +msgstr "" + +#: ../../../docs/syntax/optional.md:625 +msgid "" +"A prominent use case of field lists is for use in API docstrings, as used" +" in [Sphinx's docstring renderers](inv:sphinx#usage/domains/python):" +msgstr "" + +#: ../../../docs/syntax/optional.md:650 +msgid "Send a message to a recipient" +msgstr "" + +#: ../../../docs/syntax/optional.md:652 +msgid "The person sending the message" +msgstr "" + +#: ../../../docs/syntax/optional.md:653 +msgid "The priority of the message, can be a number 1-5" +msgstr "" + +#: ../../../docs/syntax/optional.md +msgid "Returns" +msgstr "" + +#: ../../../docs/syntax/optional.md:655 +msgid "the message id" +msgstr "" + +#: ../../../docs/syntax/optional.md +msgid "Return type" +msgstr "" + +#: ../../../docs/syntax/optional.md +msgid "Raises" +msgstr "" + +#: ../../../docs/syntax/optional.md:657 +msgid "if the message_body exceeds 160 characters" +msgstr "" + +#: ../../../docs/syntax/optional.md:642 +msgid "" +"Currently `sphinx.ext.autodoc` does not support MyST, see " +"[](howto/autodoc)." +msgstr "" + +#: ../../../docs/syntax/optional.md:646 +msgid "Attributes" +msgstr "" + +#: ../../../docs/syntax/optional.md:649 +msgid "This feature is in *beta*, and feedback is welcome." +msgstr "" + +#: ../../../docs/syntax/optional.md:651 +msgid "" +"`attrs_inline` also replace the previous `attrs_image` extension, which " +"is now deprecated." +msgstr "" + +#: ../../../docs/syntax/optional.md:654 +msgid "" +"Attributes are a way of enriching standard CommonMark syntax, by adding " +"additional information to elements." +msgstr "" + +#: ../../../docs/syntax/optional.md:656 +msgid "" +"Attributes are specified inside curly braces `{}`, for example `{#my-id " +".my-class key=\"value\"}`, and come before a block element or after an " +"inline element." +msgstr "" + +#: ../../../docs/syntax/optional.md:660 +msgid "Inside the curly braces, the following syntax is recognised:" +msgstr "" + +#: ../../../docs/syntax/optional.md:662 +msgid "" +"`.foo` specifies `foo` as a class. Multiple classes may be given in this " +"way; they will be combined." +msgstr "" + +#: ../../../docs/syntax/optional.md:664 +msgid "" +"`#foo` specifies `foo` as an identifier. An element may have only one " +"identifier; if multiple identifiers are given, the last one is used." +msgstr "" + +#: ../../../docs/syntax/optional.md:667 +msgid "" +"`key=\"value\"` or `key=value` specifies a key-value attribute. Quotes " +"are not needed when the value consists entirely of ASCII alphanumeric " +"characters or `_` or `:` or `-`. Backslash escapes may be used inside " +"quoted values. **Note** only certain keys are supported, see below." +msgstr "" + +#: ../../../docs/syntax/optional.md:672 +msgid "" +"`%` begins a comment, which ends with the next `%` or the end of the " +"attribute (`}`)." +msgstr "" + +#: ../../../docs/syntax/optional.md:674 +msgid "" +"Attributes are cumulative, so that if multiple attributes follow each " +"other, the inner attributes override the outer ones. One exception is " +"that if multiple classes are given, they are combined. For example:" +msgstr "" + +#: ../../../docs/syntax/optional.md:685 +msgid "is equivalent to:" +msgstr "" + +#: ../../../docs/syntax/optional.md:695 +msgid "" +"This is adapted from [djot inline/block " +"attributes](https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/master/doc/syntax.html" +"#inline-attributes), and also related to [pandoc bracketed " +"spans](https://pandoc.org/MANUAL.html#extension-bracketed_spans)." +msgstr "" + +#: ../../../docs/syntax/optional.md:700 +msgid "Block attributes" +msgstr "" + +#: ../../../docs/syntax/optional.md:702 +msgid "" +"By adding `\"attrs_block\"` to `myst_enable_extensions` (in the {{ confpy" +" }}), you can enable parsing of block attributes before certain block " +"syntaxes." +msgstr "" + +#: ../../../docs/syntax/optional.md:705 ../../../docs/syntax/optional.md:772 +msgid "For example, the following Markdown:" +msgstr "" + +#: ../../../docs/syntax/optional.md:722 +msgid "Here is a paragraph with attributes." +msgstr "" + +#: ../../../docs/syntax/optional.md:724 +msgid "{ref}`A reference to my paragraph `" +msgstr "" + +#: ../../../docs/syntax/optional.md:714 +msgid "" +"`id` and `class` are supported for most block syntaxes, but only certain " +"key-value attributes are supported for each syntax." +msgstr "" + +#: ../../../docs/syntax/optional.md:718 +msgid "" +"For **ordered lists**, the `style` key is supported, and can be one of " +"`decimal`, `lower-alpha`, `upper-alpha`, `lower-roman`, `upper-roman`:" +msgstr "" + +#: ../../../docs/syntax/optional.md:746 ../../../docs/syntax/optional.md:750 +#: ../../../docs/syntax/optional.md:754 ../../../docs/syntax/optional.md:758 +#: ../../../docs/syntax/typography.md:159 +#: ../../../docs/syntax/typography.md:163 +#: ../../../docs/syntax/typography.md:167 +#: ../../../docs/syntax/typography.md:171 +msgid "a" +msgstr "" + +#: ../../../docs/syntax/optional.md:747 ../../../docs/syntax/optional.md:751 +#: ../../../docs/syntax/optional.md:755 ../../../docs/syntax/optional.md:759 +#: ../../../docs/syntax/typography.md:160 +#: ../../../docs/syntax/typography.md:164 +#: ../../../docs/syntax/typography.md:168 +#: ../../../docs/syntax/typography.md:172 +msgid "b" +msgstr "" + +#: ../../../docs/syntax/optional.md:738 +msgid "" +"For **code fences**, the `lineno-start` and `emphasize-lines` keys are " +"supported:" +msgstr "" + +#: ../../../docs/syntax/optional.md:749 +msgid "For **block quotes**, the `attribution` key is supported:" +msgstr "" + +#: ../../../docs/syntax/optional.md:764 +msgid "Hallo" +msgstr "" + +#: ../../../docs/syntax/optional.md:764 +msgid "Chris Sewell, [link](https://example.com)" +msgstr "" + +#: ../../../docs/syntax/optional.md:756 +msgid "" +"For *definition lists*, the adding a glossary key turns the definition " +"list into a glossary (similar to using the [`glossary` " +"directive](inv:sphinx:rst:directive#glossary) in Sphinx):" +msgstr "" + +#: ../../../docs/syntax/optional.md:774 +msgid "term name" +msgstr "" + +#: ../../../docs/syntax/optional.md:777 +msgid "{term}`term name`" +msgstr "" + +#: ../../../docs/syntax/optional.md:767 +msgid "Inline attributes" +msgstr "" + +#: ../../../docs/syntax/optional.md:769 +msgid "" +"By adding `\"attrs_inline\"` to `myst_enable_extensions` (in the {{ " +"confpy }}), you can enable parsing of inline attributes after certain " +"inline syntaxes." +msgstr "" + +#: ../../../docs/syntax/optional.md:799 +msgid "" +"[A span of text with attributes]{#spanid .bg-warning}, {ref}`a reference " +"to the span `" +msgstr "" + +#: ../../../docs/syntax/optional.md:802 +msgid "" +"`A literal with attributes`{#literalid .bg-warning}, {ref}`a reference to" +" the literal " +msgstr "" + +#: ../../../docs/syntax/optional.md:805 +msgid "" +"An autolink with attributes: {.bg-warning title=\"a " +"title\"}" +msgstr "" + +#: ../../../docs/syntax/optional.md:807 +msgid "" +"[A link with attributes](syntax/attributes){#linkid .bg-warning}, {ref}`a" +" reference to the link `" +msgstr "" + +#: ../../../docs/syntax/optional.md:810 +msgid "" +"![An image with attribute](img/fun-fish.png){#imgid .bg-warning w=100px " +"align=center} {ref}`a reference to the image `" +msgstr "" + +#: ../../../docs/syntax/optional.md:810 +msgid "An image with attribute" +msgstr "" + +#: ../../../docs/syntax/optional.md:792 +msgid "" +"`id` and `class` are supported for most inline syntaxes, but only certain" +" key-value attributes are supported for each syntax." +msgstr "" + +#: ../../../docs/syntax/optional.md:795 +msgid "For **literals**, the following attributes are supported:" +msgstr "" + +#: ../../../docs/syntax/optional.md:797 +msgid "" +"`language`/`lexer`/`l` defines the syntax lexer, e.g. `` `a = " +"\"b\"`{l=python} `` is displayed as `a = \"b\"`{l=python}. Note, this is " +"only supported in `sphinx >= 5`." +msgstr "" + +#: ../../../docs/syntax/optional.md:801 +msgid "" +"For **images**, the following attributes are supported (equivalent to the" +" `image` directive):" +msgstr "" + +#: ../../../docs/syntax/optional.md:803 +msgid "`width`/`w` defines the width of the image (in `%`, `px`, `em`, `cm`, etc)" +msgstr "" + +#: ../../../docs/syntax/optional.md:804 +msgid "`height`/`h` defines the height of the image (in `px`, `em`, `cm`, etc)" +msgstr "" + +#: ../../../docs/syntax/optional.md:805 +msgid "`align`/`a` defines the scale of the image (`left`, `center`, or `right`)" +msgstr "" + +#: ../../../docs/syntax/optional.md:809 +msgid "HTML Images" +msgstr "" + +#: ../../../docs/syntax/optional.md:811 +msgid "" +"MyST provides a few different syntaxes for including images in your " +"documentation, as explained below." +msgstr "" + +#: ../../../docs/syntax/optional.md:813 +msgid "The first is the standard Markdown syntax:" +msgstr "" + +#: ../../../docs/syntax/optional.md:819 +msgid "" +"This will correctly copy the image to the build folder and will render it" +" in all output formats (HTML, TeX, etc). However, it is limited in the " +"configuration that can be applied, for example setting a width." +msgstr "" + +#: ../../../docs/syntax/optional.md:822 +msgid "" +"As discussed [above](syntax/directives), MyST allow for directives to be " +"used such as `image` and `figure` (see {ref}`the sphinx documentation " +"`):" +msgstr "" + +#: ../../../docs/syntax/optional.md:833 +msgid "" +"Additional options can now be set, however, in contrast to the Markdown " +"syntax, this syntax will not show the image in common Markdown viewers " +"(for example when the files are viewed on GitHub)." +msgstr "" + +#: ../../../docs/syntax/optional.md:835 +msgid "" +"The final option is directly using HTML, which is also parsed by MyST. " +"This is usually a bad option, because the HTML is treated as raw text " +"during the build process and so sphinx will not recognise that the image " +"file is to be copied, and will not output the HTML into non-HTML output " +"formats." +msgstr "" + +#: ../../../docs/syntax/optional.md:838 +msgid "HTML parsing to the rescue!" +msgstr "" + +#: ../../../docs/syntax/optional.md:840 +msgid "" +"By adding `\"html_image\"` to `myst_enable_extensions` (in the {{ confpy " +"}}), MySt-Parser will attempt to convert any isolated `img` tags (i.e. " +"not wrapped in any other HTML) to the internal representation used in " +"sphinx." +msgstr "" + +#: ../../../docs/syntax/optional.md:850 +msgid "" +"Allowed attributes are equivalent to the `image` directive: `src`, `alt`," +" `class`, `width`, `height` and `name`. Any other attributes will be " +"dropped." +msgstr "" + +#: ../../../docs/syntax/optional.md:853 +msgid "HTML image can also be used inline!" +msgstr "" + +#: ../../../docs/syntax/optional.md:855 +msgid "I'm an inline image: " +msgstr "" + +#: ../../../docs/syntax/optional.md:859 +msgid "Markdown Figures" +msgstr "" + +#: ../../../docs/syntax/optional.md:861 +msgid "" +"By adding `\"colon_fence\"` to `myst_enable_extensions` (in the {{ confpy" +" }}), we can combine the above two extended syntaxes, to create a fully " +"Markdown compliant version of the `figure` directive named `figure-md`." +msgstr "" + +#: ../../../docs/syntax/optional.md:866 +msgid "" +"`myst_figure_enable` with the `figure` directive is deprecated and " +"replaced by `myst_enable_extensions = [\"colon_fence\"]` and `figure-md`." +msgstr "" + +#: ../../../docs/syntax/optional.md:869 +msgid "" +"The figure block must contain **only** two components; an image, in " +"either Markdown or HTML syntax, and a single paragraph for the caption." +msgstr "" + +#: ../../../docs/syntax/optional.md:871 +msgid "" +"The first line argument is optional and taken as the reference target of " +"the figure:" +msgstr "" + +#: ../../../docs/syntax/optional.md:901 ../../../docs/syntax/optional.md:909 +msgid "This is a caption in **Markdown**" +msgstr "" + +#: ../../../docs/syntax/optional.md:891 +msgid "As we see here, the target we set can be referenced:" +msgstr "" + +#: ../../../docs/syntax/optional.md:904 +msgid "[Go to the fish!](#fig-target)" +msgstr "" + +#: ../../../docs/syntax/optional.md:899 +msgid "HTML Admonitions" +msgstr "" + +#: ../../../docs/syntax/optional.md:901 +msgid "" +"By adding `\"html_admonition\"` to `myst_enable_extensions` (in the {{ " +"confpy }}), you can enable parsing of `
` HTML " +"blocks. These blocks will be converted internally to Sphinx admonition " +"directives, and so will work correctly for all output formats. This is " +"helpful when you care about viewing the \"source\" Markdown, such as in " +"Jupyter Notebooks." +msgstr "" + +#: ../../../docs/syntax/optional.md:906 +msgid "" +"If the first element within the `div` is `
` or `

`, then this will be set as the admonition title. All " +"internal text (and the title) will be parsed as MyST-Markdown and all " +"classes and an optional name will be passed to the admonition:" +msgstr "" + +#: ../../../docs/syntax/optional.md:925 +msgid "This is the **title**" +msgstr "" + +#: ../../../docs/syntax/optional.md:929 +msgid "This is the *content*" +msgstr "" + +#: ../../../docs/syntax/optional.md:918 +msgid "" +"During the Sphinx render, both the `class` and `name` attributes will be " +"used by Sphinx, but any other attributes like `style` will be discarded." +msgstr "" + +#: ../../../docs/syntax/optional.md:921 +msgid "" +"There can be no empty lines in the block, otherwise they will be read as " +"two separate blocks. If you want to use multiple paragraphs then they can" +" be enclosed in `

`:" +msgstr "" + +#: ../../../docs/syntax/optional.md:939 ../../../docs/syntax/optional.md:955 +msgid "Note" +msgstr "" + +#: ../../../docs/syntax/optional.md:943 ../../../docs/syntax/optional.md:964 +msgid "Paragraph 1" +msgstr "" + +#: ../../../docs/syntax/optional.md:945 ../../../docs/syntax/optional.md:966 +msgid "Paragraph 2" +msgstr "" + +#: ../../../docs/syntax/optional.md:934 +msgid "You can also nest HTML admonitions:" +msgstr "" + +#: ../../../docs/syntax/optional.md:958 +msgid "Some **content**" +msgstr "" + +#: ../../../docs/syntax/optional.md:960 +msgid "A *title*" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:3 +msgid "Organising content" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:5 +msgid "" +"Sphinx allows you to organise your content into multiple documents, and " +"to include content from other documents." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:7 +msgid "This section describes how to do this with MyST Markdown." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:10 +msgid "Document structure" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:12 +msgid "" +"Single MyST Markdown documents are structured using " +"[headings](typography.md#headings)." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:14 +msgid "" +"All headings at the root level of the document are included in the Table " +"of Contents (ToC) for that page." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:16 +msgid "" +"Many HTML themes will already include this ToC in a sidebar, but you can " +"also include it in the main content of the page using the contents " +"{{directive}}:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:30 +msgid "Table of Contents" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:24 +msgid "Options:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:26 +msgid "depth" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:26 +msgid "Can be used to specify the depth of the ToC." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:27 +msgid "local" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:27 +msgid "" +"Can be used to only include headings in the current section of the " +"document." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:28 +msgid "backlinks" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:28 +msgid "Can be used to include a link to the ToC at the end of each section." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:29 +msgid "Is available to add a custom CSS class to the ToC." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:33 +msgid "" +"Because the structure of the document is determined by the headings, it " +"is problematic to have \"non-consecutive\" headings in a document, such " +"as:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:40 +msgid "" +"If you wish to include such a heading, you can use the " +"[attrs_block](#syntax/attributes/block) extension to wrap the heading in " +"a `div`, so that it is not included in the ToC:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:52 +msgid "Setting a title in front-matter" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:59 +msgid "" +"The `myst_title_to_header = True`{l=python} [configuration](#sphinx" +"/config-options) allows for a `title` key to be present in the [document " +"front matter](#syntax/frontmatter)." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:62 +msgid "" +"This will then be used as the document's header (parsed as Markdown). For" +" example:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:71 +msgid "would be equivalent to:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:79 +msgid "Inserting other documents directly into the current document" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:81 +msgid "" +"The `include` directive allows you to insert the contents of another " +"document directly into the flow of the current document." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:84 +msgid "" +"The [`literalinclude` directive](#syntax/literalinclude), for including " +"source code from files." +msgstr "" + +#: ../../../docs/syntax/example.txt:2 +msgid "Hallo there you!" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:95 +msgid "The following options allow you to include only part of a document:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:97 +msgid "start-line" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:97 +msgid "" +"Only the content starting from this line number will be included " +"(numbering starts at 1, and negative count from the end)" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:98 +msgid "end-line" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:98 +msgid "Only the content up to (but excluding) this line will be included." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:99 +msgid "start-after" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:99 +msgid "" +"Only the content after the first occurrence of the specified text will be" +" included." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:100 +msgid "end-before" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:100 +msgid "" +"Only the content before the first occurrence of the specified text (but " +"after any after text) will be included." +msgstr "" + +#: ../../../docs/syntax/example.txt:3 ../../../docs/syntax/example.txt:8 +msgid "there" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:117 +msgid "" +"The following options allow you to modify the content of the included " +"document, to make it relative to the location that it is being inserted:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:120 +msgid "heading-offset" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:120 +msgid "" +"Offset all the heading levels by this positive integer, e.g. changing `#`" +" to `####`" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:121 +msgid "relative-docs" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:121 +msgid "" +"Make Markdown file references, relative to the current document, if they " +"start with a certain prefix" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:122 +msgid "relative-images" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:122 +msgid "Make Markdown image references, relative to the current document" +msgstr "" + +#: ../../../docs/syntax/examples/example_relative_include.txt:2 +msgid "My heading" +msgstr "" + +#: ../../../docs/syntax/examples/example_relative_include.txt:4 +msgid "[](../typography.md) ![alt](../img/fun-fish.png){w=50}" +msgstr "" + +#: ../../../docs/syntax/examples/example_relative_include.txt:4 +msgid "alt" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:135 +#: ../../../docs/syntax/organising_content.md:192 +msgid "Additional options:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:136 +msgid "encoding" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:136 +msgid "The text encoding of the external file" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:138 +msgid "Including to/from reStructuredText files" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:142 +msgid "" +"As explained in [this section](#syntax/directives/parsing), all MyST " +"directives will parse their content as Markdown. So to include rST, we " +"must first \"wrap\" the directive in the [eval-rst " +"directive](#syntax/directives/parsing):" +msgstr "" + +#: ../../../docs/faq/snippets/include-rst.rst:1 +msgid "Hallo I'm from an rST file, :ref:`with a reference `." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:151 +msgid "" +"To include a MyST file within a ReStructuredText file, we can use the " +"`parser` option of the `include` directive:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:159 +msgid "The `parser` option requires `docutils>=0.17`" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:164 +msgid "Using `toctree` to include other documents as children" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:166 +msgid "" +"To structure a project, with multiple documents, the [toctree " +"directive](inv:sphinx:*:directive#toctree) is utilised." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:168 +msgid "" +"The designate documents as children of the current document, building up " +"a nested hierarchy of documents starting from a " +"[`root_doc`](inv:sphinx:*:confval#root_doc)." +msgstr "" + +#: ../../../docs/syntax/organising_content.md:178 +msgid "The `toctree` has options:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:180 +msgid "glob" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:180 +msgid "" +"Indicates that all entries are then matched against the list of available" +" documents, and matches are inserted into the list alphabetically" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:183 +msgid "The following options to control how it is displayed within the document:" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:185 +msgid "caption" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:185 +msgid "A title for this toctree" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:186 +msgid "hidden" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:186 +msgid "Do not show within the document" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:187 +msgid "includehidden" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:187 +msgid "Included child hidden `toctree` entries" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:188 +msgid "maxdepth" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:188 +msgid "The depth of document sub-headings shown" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:189 +msgid "titlesonly" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:189 +msgid "Only show the first top-level heading" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:190 +msgid "reversed" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:190 +msgid "Reverse the order of the entries in the list" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:194 +msgid "Allow the `toctree` to be referenced" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:195 +msgid "numbered" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:195 +msgid "" +"Number all headings in children. If an integer is specified, then this is" +" the depth to number down to" +msgstr "" + +#: ../../../docs/syntax/organising_content.md:198 +msgid "" +"Sub-toctrees are automatically numbered, so don’t give the `:numbered:` " +"flag to those" +msgstr "" + +#: ../../../docs/syntax/reference.md:2 +msgid "Syntax tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:4 +msgid "" +"This page serves as a reference for the syntax that makes of MyST " +"Markdown." +msgstr "" + +#: ../../../docs/syntax/reference.md:7 +msgid "" +"For more description and explanation of MyST syntax, see the [syntax " +"guide](typography.md)." +msgstr "" + +#: ../../../docs/syntax/reference.md:10 +msgid "Block (Multi-line) Tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:12 +msgid "" +"Block tokens span multiple lines of content. They are broken down into " +"two sections:" +msgstr "" + +#: ../../../docs/syntax/reference.md:14 +msgid "" +"{ref}`extended-block-tokens` contains *extra* tokens that are not in " +"CommonMark." +msgstr "" + +#: ../../../docs/syntax/reference.md:15 +msgid "" +"{ref}`commonmark-block-tokens` contains CommonMark tokens that also work," +" for reference." +msgstr "" + +#: ../../../docs/syntax/reference.md:18 +msgid "" +"Because MyST markdown was inspired by functionality that exists in " +"reStructuredText, we have shown equivalent rST syntax for many MyST " +"markdown features below." +msgstr "" + +#: ../../../docs/syntax/reference.md:23 +msgid "Extended block tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:29 ../../../docs/syntax/reference.md:97 +#: ../../../docs/syntax/reference.md:173 ../../../docs/syntax/reference.md:207 +msgid "Token" +msgstr "" + +#: ../../../docs/syntax/reference.md:30 ../../../docs/syntax/reference.md:98 +#: ../../../docs/syntax/reference.md:174 ../../../docs/syntax/reference.md:208 +#: ../../../docs/syntax/tables.md:114 ../../../docs/syntax/tables.md:159 +msgid "Description" +msgstr "" + +#: ../../../docs/syntax/reference.md:31 ../../../docs/syntax/reference.md:99 +#: ../../../docs/syntax/reference.md:175 ../../../docs/syntax/reference.md:209 +msgid "Example" +msgstr "" + +#: ../../../docs/syntax/reference.md:32 +msgid "FrontMatter" +msgstr "" + +#: ../../../docs/syntax/reference.md:33 +msgid "A YAML block at the start of the document enclosed by `---`" +msgstr "" + +#: ../../../docs/syntax/reference.md:39 +msgid "Directives" +msgstr "" + +#: ../../../docs/syntax/reference.md:40 +msgid "" +"enclosed in 3 or more backticks followed by the directive name wrapped in" +" curly brackets `{}`. See {ref}`syntax/directives` for more details." +msgstr "" + +#: ../../../docs/syntax/reference.md:49 ../../../docs/syntax/reference.md:187 +msgid "Math" +msgstr "" + +#: ../../../docs/syntax/reference.md:50 +msgid "" +"`$$` (default) or `\\[`...`\\]` characters wrapping multi-line math, or " +"even direct [amsmath](https://ctan.org/pkg/amsmath) LaTeX equations " +"(optional). See {ref}`syntax/math` for more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:57 +msgid "Table" +msgstr "" + +#: ../../../docs/syntax/reference.md:58 +msgid "Standard markdown table style, with pipe separation." +msgstr "" + +#: ../../../docs/syntax/reference.md:64 +msgid "LineComment" +msgstr "" + +#: ../../../docs/syntax/reference.md:65 +msgid "A commented line. See {ref}`syntax/comments` for more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:69 +msgid "BlockBreak" +msgstr "" + +#: ../../../docs/syntax/reference.md:70 +msgid "Define blocks of text. See {ref}`syntax/blockbreaks` for more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:74 +msgid "Footnote" +msgstr "" + +#: ../../../docs/syntax/reference.md:75 +msgid "" +"A definition for a referencing footnote, that is placed at the bottom of " +"the document. See {ref}`syntax/footnotes` for more details." +msgstr "" + +#: ../../../docs/syntax/reference.md:80 +msgid "Admonitions (optional)" +msgstr "" + +#: ../../../docs/syntax/reference.md:81 +msgid "" +"An alternative approach for admonition style directives only, which has " +"the benefit of allowing the content to be rendered in standard markdown " +"editors. See [admonition directives](syntax/admonitions) for more " +"details." +msgstr "" + +#: ../../../docs/syntax/reference.md:91 +msgid "CommonMark tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:100 +msgid "HTMLBlock" +msgstr "" + +#: ../../../docs/syntax/reference.md:101 ../../../docs/syntax/reference.md:211 +msgid "Any valid HTML (rendered in HTML output only)" +msgstr "" + +#: ../../../docs/syntax/reference.md:105 +msgid "BlockCode" +msgstr "" + +#: ../../../docs/syntax/reference.md:106 +msgid "indented text (4 spaces or a tab)" +msgstr "" + +#: ../../../docs/syntax/reference.md:111 +msgid "Level 1-6 headings, denoted by number of `#`" +msgstr "" + +#: ../../../docs/syntax/reference.md:115 +msgid "SetextHeading" +msgstr "" + +#: ../../../docs/syntax/reference.md:116 +msgid "Underlined header (using multiple `=` or `-`)" +msgstr "" + +#: ../../../docs/syntax/reference.md:121 +msgid "Quote" +msgstr "" + +#: ../../../docs/syntax/reference.md:122 +msgid "Quoted text" +msgstr "" + +#: ../../../docs/syntax/reference.md:126 +msgid "CodeFence" +msgstr "" + +#: ../../../docs/syntax/reference.md:127 +msgid "" +"Enclosed in 3 or more `` ` `` or `~` with an optional language name. See " +"{ref}`syntax/code-blocks` for more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:134 +msgid "ThematicBreak" +msgstr "" + +#: ../../../docs/syntax/reference.md:135 +msgid "Creates a horizontal line in the output" +msgstr "" + +#: ../../../docs/syntax/reference.md:139 +msgid "List" +msgstr "" + +#: ../../../docs/syntax/reference.md:140 +msgid "bullet points or enumerated." +msgstr "" + +#: ../../../docs/syntax/reference.md:146 +msgid "LinkDefinition" +msgstr "" + +#: ../../../docs/syntax/reference.md:147 +msgid "" +"A substitution for an inline link, which can have a reference target (no " +"spaces), and an optional title (in `\"`)" +msgstr "" + +#: ../../../docs/syntax/reference.md:151 +msgid "Paragraph" +msgstr "" + +#: ../../../docs/syntax/reference.md:152 +msgid "General inline text" +msgstr "" + +#: ../../../docs/syntax/reference.md:158 +msgid "Span (Inline) Tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:160 +msgid "" +"Span (or inline) tokens are defined on a single line of content. They are" +" broken down into two sections below:" +msgstr "" + +#: ../../../docs/syntax/reference.md:163 +msgid "" +"{ref}`extended-span-tokens` contains *extra* tokens that are not in " +"CommonMark." +msgstr "" + +#: ../../../docs/syntax/reference.md:164 +msgid "" +"{ref}`commonmark-span-tokens` contains CommonMark tokens that also work, " +"for reference." +msgstr "" + +#: ../../../docs/syntax/reference.md:167 +msgid "Extended inline tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:176 +msgid "Role" +msgstr "" + +#: ../../../docs/syntax/reference.md:177 +msgid "See {ref}`syntax/roles` for more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:181 +msgid "Target" +msgstr "" + +#: ../../../docs/syntax/reference.md:182 +msgid "" +"Precedes element to target, e.g. header. See {ref}`syntax/targets` for " +"more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:188 +msgid "" +"`$` (default) or `\\(`...`\\)` enclosed math. See {ref}`syntax/math` for " +"more information." +msgstr "" + +#: ../../../docs/syntax/reference.md:193 +msgid "FootReference" +msgstr "" + +#: ../../../docs/syntax/reference.md:194 +msgid "Reference a footnote. See {ref}`syntax/footnotes` for more details." +msgstr "" + +#: ../../../docs/syntax/reference.md:201 +msgid "CommonMark inline tokens" +msgstr "" + +#: ../../../docs/syntax/reference.md:210 +msgid "HTMLSpan" +msgstr "" + +#: ../../../docs/syntax/reference.md:215 +msgid "EscapeSequence" +msgstr "" + +#: ../../../docs/syntax/reference.md:216 +msgid "Escaped symbols (to avoid them being interpreted as other syntax elements)" +msgstr "" + +#: ../../../docs/syntax/reference.md:220 +msgid "AutoLink" +msgstr "" + +#: ../../../docs/syntax/reference.md:221 +msgid "Link that is shown in final output" +msgstr "" + +#: ../../../docs/syntax/reference.md:225 +msgid "InlineCode" +msgstr "" + +#: ../../../docs/syntax/reference.md:226 +msgid "Literal text" +msgstr "" + +#: ../../../docs/syntax/reference.md:230 +msgid "LineBreak" +msgstr "" + +#: ../../../docs/syntax/reference.md:231 +msgid "Soft or hard (ends with spaces or backslash)" +msgstr "" + +#: ../../../docs/syntax/reference.md:235 +msgid "Image" +msgstr "" + +#: ../../../docs/syntax/reference.md:236 +msgid "" +"Link to an image. You can also use HTML syntax, to include image size " +"etc, [see here](syntax/images) for details" +msgstr "" + +#: ../../../docs/syntax/reference.md:241 +msgid "Link" +msgstr "" + +#: ../../../docs/syntax/reference.md:242 +msgid "" +"Reference `LinkDefinitions`. See {ref}`syntax/referencing` for more " +"details." +msgstr "" + +#: ../../../docs/syntax/reference.md:246 +msgid "Strong" +msgstr "" + +#: ../../../docs/syntax/reference.md:247 +msgid "Bold text" +msgstr "" + +#: ../../../docs/syntax/reference.md:251 +msgid "Emphasis" +msgstr "" + +#: ../../../docs/syntax/reference.md:252 +msgid "Italic text" +msgstr "" + +#: ../../../docs/syntax/reference.md:256 +msgid "RawText" +msgstr "" + +#: ../../../docs/syntax/reference.md:257 +msgid "Any text" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:3 +msgid "Roles and Directives" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:5 +msgid "" +"Roles and directives provide a way to extend the syntax of MyST in an " +"unbound manner, by interpreting a chuck of text as a specific type of " +"markup, according to its name." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:8 +msgid "" +"Mostly all [docutils " +"roles](https://docutils.sourceforge.io/docs/ref/rst/roles.html), " +"[docutils " +"directives](https://docutils.sourceforge.io/docs/ref/rst/directives.html)," +" [Sphinx roles](inv:sphinx#usage/*/roles), or [Sphinx " +"directives](inv:sphinx#usage/*/directives) can be used in MyST." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:19 +msgid "Directives - a block-level extension point" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:21 +msgid "" +"Directives syntax is defined with triple-backticks and curly-brackets. It" +" is effectively a Markdown code fence with curly brackets around the " +"language, and a directive name in place of a language name. Here is the " +"basic structure:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:28 +#: ../../../docs/syntax/roles-and-directives.md:228 +msgid "MyST" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:29 +#: ../../../docs/syntax/roles-and-directives.md:229 +msgid "reStructuredText" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:64 +msgid "This is my admonition" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:65 +msgid "This is my note" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:57 +msgid "Parameterizing directives (options)" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:59 +msgid "" +"Many directives can take key/value pairs, in an optional *option block* " +"at the start of the directive." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:61 +msgid "" +"The option block starts on the first line of the directive body and is " +"defined by a set of lines prefixed with `:`." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:63 +msgid "" +"The block then follows a YAML-like mapping syntax, where the key (string)" +" and value (string) are separated by a colon (`:`):" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:76 +msgid "" +"The values can be enclosed in quotes (`\"` or `'`) and span multiple " +"lines. Newline behaviour can be controlled by starting the value with `|`" +" (preserve newlines) or `>` (collapse newlines):" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:100 +#: ../../../docs/syntax/roles-and-directives.md:119 +msgid "This is my multi-line caption. It is *pretty nifty* ;-)" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md +msgid "Old-style options block" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:95 +msgid "" +"Option blocks can also be enclosed by `---`, with no `:` prefix, for " +"example:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:116 +msgid "How directives parse content" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:118 +msgid "" +"Some directives parse the content that is in their content block. MyST " +"parses this content **as Markdown**." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:121 +msgid "" +"This means that MyST markdown can be written in the content areas of any " +"directives written in MyST markdown. For example:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:136 +msgid "My markdown link" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:137 +msgid "Here is [markdown link syntax](https://jupyter.org)" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:129 +msgid "" +"As a short-hand for directives that require no arguments, and when no " +"parameter options are used (see below), you may start the content " +"directly after the directive name." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:145 +msgid "Notes require **no** arguments, so content can start here." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:137 +msgid "" +"For special cases, MySt also offers the `eval-rst` directive. This will " +"parse the content **as ReStructuredText**:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:166 +msgid "Party time!" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:168 +msgid "A reference from inside: :ref:`rst-fun-fish`" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:170 +msgid "A reference from outside: :ref:`syntax/directives/parsing`" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:154 +msgid "" +"Note how the text is integrated into the rest of the document, so we can " +"also reference [party fish](rst-fun-fish) anywhere else in the " +"documentation." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:156 +msgid "Nesting directives" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:158 +msgid "" +"You can nest directives by ensuring that the tick-lines corresponding to " +"the outermost directive are longer than the tick-lines for the inner " +"directives. For example, nest a warning inside a note block like so:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:179 +#: ../../../docs/syntax/roles-and-directives.md:215 +msgid "The next info should be nested" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:181 +#: ../../../docs/syntax/roles-and-directives.md:201 +#: ../../../docs/syntax/roles-and-directives.md:217 +msgid "Here's my warning" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:171 +msgid "" +"You can indent inner-code fences, so long as they aren't indented by more" +" than 3 spaces. Otherwise, they will be rendered as \"raw code\" blocks:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:198 +msgid "The warning block will be properly-parsed" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:204 +msgid "But the next block will be parsed as raw text" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:190 +msgid "This can really be abused if you'd like ;-)" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:218 +msgid "Yep another admonition" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:207 +msgid "Markdown-friendly directives" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:209 +msgid "" +"Want to use syntax that renders correctly in standard Markdown editors? " +"See [the extended syntax option](syntax/colon_fence)." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:227 +msgid "This text is **standard** *Markdown*" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:220 +msgid "Roles - an in-line extension point" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:222 +msgid "" +"Roles are similar to directives - they allow you to define arbitrary new " +"functionality, but they are used *in-line*. To define an in-line role, " +"use the following form:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:251 +msgid "Since Pythagoras, we know that {math}`a^2 + b^2 = c^2`" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:244 +msgid "" +"You can use roles to do things like reference equations and other items " +"in your book. For example:" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:263 +msgid "" +"e^{i\\pi} + 1 = 0\n" +"\n" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:267 +msgid "" +"Euler's identity, equation {math:numref}`euler`, was elected one of the " +"most beautiful mathematical formulas." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:256 +msgid "How roles parse content" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:258 +msgid "" +"The content of roles is parsed differently depending on the role that " +"you've used. Some roles expect inputs that will be used to change " +"functionality. For example, the `ref` role will assume that input content" +" is a reference to some other part of the site. However, other roles may " +"use the MyST parser to parse the input as content." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:263 +msgid "" +"Some roles also **extend their functionality** depending on the content " +"that you pass. For example, following the `ref` example above, if you " +"pass a string like this: `Content to display `, then the `ref` " +"will display `Content to display` and use `myref` as the reference to " +"look up." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:268 +msgid "How roles parse this content depends on the author that created the role." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:272 +msgid "MyST only roles" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:274 +msgid "" +"This section contains information about special roles and directives that" +" come bundled with the MyST Parser Sphinx extension." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:276 +msgid "Insert the date and reading time" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:279 +msgid "The `sub-ref` role and word counting." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:282 +msgid "" +"You may insert the \"last updated\" date and estimated reading time into " +"your document via substitution definitions, which can be accessed *via* " +"the `sub-ref` role." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:297 +msgid "" +"{sub-ref}`today` | {sub-ref}`wordcount-words` words | {sub-ref" +"}`wordcount-minutes` min read" +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:290 +msgid "" +"`today` is replaced by either the date on which the document is parsed, " +"with the format set by , or the `today` variable if" +" set in the configuration file." +msgstr "" + +#: ../../../docs/syntax/roles-and-directives.md:292 +msgid "" +"The reading speed is computed using the `myst_words_per_minute` " +"configuration (see the [Sphinx configuration options](sphinx/config-" +"options))." +msgstr "" + +#: ../../../docs/syntax/tables.md:1 +msgid "Tables" +msgstr "" + +#: ../../../docs/syntax/tables.md:3 +msgid "Markdown syntax" +msgstr "" + +#: ../../../docs/syntax/tables.md:5 +msgid "" +"Tables can be written using the standard [Github Flavoured Markdown " +"syntax](https://github.github.com/gfm/#tables-extension-):" +msgstr "" + +#: ../../../docs/syntax/tables.md:13 +msgid "Cells in a column can be aligned using the `:` character:" +msgstr "" + +#: ../../../docs/syntax/tables.md:21 +msgid "Aligning cells in Sphinx HTML themes" +msgstr "" + +#: ../../../docs/syntax/tables.md:25 +msgid "" +"Text is aligned by assigning `text-left`, `text-center`, or `text-right` " +"to the cell. It is then necessary for the theme you are using to include " +"the appropriate css styling." +msgstr "" + +#: ../../../docs/syntax/tables.md:40 +msgid "Table with captions" +msgstr "" + +#: ../../../docs/syntax/tables.md:42 +msgid "The `table` directive can be used to create a table with a caption:" +msgstr "" + +#: ../../../docs/syntax/tables.md:63 +msgid "Table caption" +msgstr "" + +#: ../../../docs/syntax/tables.md:57 ../../../docs/syntax/tables.md:103 +msgid "List table options" +msgstr "" + +#: ../../../docs/syntax/tables.md:61 ../../../docs/syntax/tables.md:107 +#: ../../../docs/syntax/tables.md:153 +msgid "`align` : \"left\", \"center\", or \"right\"" +msgstr "" + +#: ../../../docs/syntax/tables.md:62 ../../../docs/syntax/tables.md:108 +#: ../../../docs/syntax/tables.md:154 +msgid "The horizontal alignment of the table." +msgstr "" + +#: ../../../docs/syntax/tables.md:64 ../../../docs/syntax/tables.md:116 +#: ../../../docs/syntax/tables.md:192 +msgid "`width` : [length](units/length) or [percentage](units/percentage)" +msgstr "" + +#: ../../../docs/syntax/tables.md:65 ../../../docs/syntax/tables.md:117 +msgid "" +"Sets the width of the table to the specified length or percentage of the " +"line width." +msgstr "" + +#: ../../../docs/syntax/tables.md:66 ../../../docs/syntax/tables.md:118 +msgid "" +"If omitted, the renderer determines the width of the table based on its " +"contents or the column widths." +msgstr "" + +#: ../../../docs/syntax/tables.md:68 +msgid "`widths` : \"auto\", \"grid\", or a list of integers" +msgstr "" + +#: ../../../docs/syntax/tables.md:69 +msgid "" +"Explicitly set column widths. Specifies relative widths if used with the " +"width option." +msgstr "" + +#: ../../../docs/syntax/tables.md:70 ../../../docs/syntax/tables.md:190 +msgid "" +"\"auto\" delegates the determination of column widths to the backend " +"renderer." +msgstr "" + +#: ../../../docs/syntax/tables.md:71 +msgid "" +"\"grid\" determines column widths from the widths of the input columns " +"(in characters)." +msgstr "" + +#: ../../../docs/syntax/tables.md:74 +msgid "List tables" +msgstr "" + +#: ../../../docs/syntax/tables.md:76 +msgid "" +"The `list-table` directive is used to create a table from data in a " +"uniform two-level bullet list. \"Uniform\" means that each sublist " +"(second-level list) must contain the same number of list items." +msgstr "" + +#: ../../../docs/syntax/tables.md:108 ../../../docs/syntax/tables.md:154 +msgid "Frozen Delights!" +msgstr "" + +#: ../../../docs/syntax/tables.md:112 ../../../docs/syntax/tables.md:159 +msgid "Treat" +msgstr "" + +#: ../../../docs/syntax/tables.md:113 ../../../docs/syntax/tables.md:159 +msgid "Quantity" +msgstr "" + +#: ../../../docs/syntax/tables.md:115 ../../../docs/syntax/tables.md:159 +msgid "Albatross" +msgstr "" + +#: ../../../docs/syntax/tables.md:116 ../../../docs/syntax/tables.md:159 +msgid "2.99" +msgstr "" + +#: ../../../docs/syntax/tables.md:117 ../../../docs/syntax/tables.md:124 +#: ../../../docs/syntax/tables.md:159 +msgid "On a stick!" +msgstr "" + +#: ../../../docs/syntax/tables.md:118 ../../../docs/syntax/tables.md:159 +msgid "Crunchy Frog" +msgstr "" + +#: ../../../docs/syntax/tables.md:119 ../../../docs/syntax/tables.md:159 +msgid "1.49" +msgstr "" + +#: ../../../docs/syntax/tables.md:120 ../../../docs/syntax/tables.md:159 +msgid "If we took the bones out, it wouldn't be crunchy, now would it?" +msgstr "" + +#: ../../../docs/syntax/tables.md:122 ../../../docs/syntax/tables.md:159 +msgid "Gannet Ripple" +msgstr "" + +#: ../../../docs/syntax/tables.md:123 ../../../docs/syntax/tables.md:159 +msgid "1.99" +msgstr "" + +#: ../../../docs/syntax/tables.md:110 ../../../docs/syntax/tables.md:173 +msgid "`header-rows` : integer" +msgstr "" + +#: ../../../docs/syntax/tables.md:111 +msgid "The number of rows of list data to use in the table header. Defaults to 0." +msgstr "" + +#: ../../../docs/syntax/tables.md:113 ../../../docs/syntax/tables.md:182 +msgid "`stub-columns` : integer" +msgstr "" + +#: ../../../docs/syntax/tables.md:114 ../../../docs/syntax/tables.md:183 +msgid "" +"The number of table columns to use as stubs (row titles, on the left). " +"Defaults to 0." +msgstr "" + +#: ../../../docs/syntax/tables.md:120 +msgid "`widths` : integer `[integer...]` or \"auto\"" +msgstr "" + +#: ../../../docs/syntax/tables.md:121 ../../../docs/syntax/tables.md:189 +msgid "" +"A list of relative column widths. The default is equal-width columns " +"(100%/#columns)." +msgstr "" + +#: ../../../docs/syntax/tables.md:122 +msgid "" +"\"auto\" delegates the determination of column widths to the output " +"builder." +msgstr "" + +#: ../../../docs/syntax/tables.md:125 ../../../docs/syntax/tables.md:196 +msgid "A space-separated list of CSS classes to add to the table." +msgstr "" + +#: ../../../docs/syntax/tables.md:131 +msgid "CSV tables" +msgstr "" + +#: ../../../docs/syntax/tables.md:133 +msgid "" +"The `csv-table` directive is used to create a table from Comma-Separated-" +"Values data." +msgstr "" + +#: ../../../docs/syntax/tables.md:149 +msgid "CSV table options" +msgstr "" + +#: ../../../docs/syntax/tables.md:156 +msgid "`delim` : char | \"tab\" | \"space\"" +msgstr "" + +#: ../../../docs/syntax/tables.md:157 +msgid "" +"A one-character string used to separate fields. Defaults to , (comma). " +"May be specified as a Unicode code point; see the unicode directive for " +"syntax details." +msgstr "" + +#: ../../../docs/syntax/tables.md:160 +msgid "`encoding` : string" +msgstr "" + +#: ../../../docs/syntax/tables.md:161 +msgid "" +"The text encoding of the external CSV data (file or URL). Defaults to the" +" document's input_encoding." +msgstr "" + +#: ../../../docs/syntax/tables.md:164 +msgid "`escape` : char" +msgstr "" + +#: ../../../docs/syntax/tables.md:165 +msgid "" +"A one-character string used to escape the delimiter or quote characters. " +"May be specified as a Unicode code point; see the unicode directive for " +"syntax details. Used when the delimiter is used in an unquoted field, or " +"when quote characters are used within a field. The default is to double-" +"up the character, e.g. \"He said, \"\"Hi!\"\"\"" +msgstr "" + +#: ../../../docs/syntax/tables.md:167 +msgid "`file` : string (newlines removed)" +msgstr "" + +#: ../../../docs/syntax/tables.md:168 +msgid "The local filesystem path to a CSV data file." +msgstr "" + +#: ../../../docs/syntax/tables.md:170 +msgid "`header` : CSV data" +msgstr "" + +#: ../../../docs/syntax/tables.md:171 +msgid "" +"Supplemental data for the table header, added independently of and before" +" any header-rows from the main CSV data. Must use the same CSV format as " +"the main CSV data." +msgstr "" + +#: ../../../docs/syntax/tables.md:174 +msgid "The number of rows of CSV data to use in the table header. Defaults to 0." +msgstr "" + +#: ../../../docs/syntax/tables.md:176 +msgid "`keepspace` : flag" +msgstr "" + +#: ../../../docs/syntax/tables.md:177 +msgid "" +"Treat whitespace immediately following the delimiter as significant. The " +"default is to ignore such whitespace." +msgstr "" + +#: ../../../docs/syntax/tables.md:179 +msgid "`quote` : char" +msgstr "" + +#: ../../../docs/syntax/tables.md:180 +msgid "" +"A one-character string used to quote elements containing the delimiter or" +" which start with the quote character. Defaults to \" (quote). May be " +"specified as a Unicode code point; see the unicode directive for syntax " +"details." +msgstr "" + +#: ../../../docs/syntax/tables.md:185 +msgid "`url` : string (whitespace removed)" +msgstr "" + +#: ../../../docs/syntax/tables.md:186 +msgid "An Internet URL reference to a CSV data file." +msgstr "" + +#: ../../../docs/syntax/tables.md:188 +msgid "`widths` : integer, `[integer...]` or \"auto\"" +msgstr "" + +#: ../../../docs/syntax/tables.md:193 +msgid "" +"Sets the width of the table to the specified length or percentage of the " +"line width. If omitted, the renderer determines the width of the table " +"based on its contents or the column widths." +msgstr "" + +#: ../../../docs/syntax/typography.md:5 +msgid "" +"MyST is a strict superset of the [CommonMark syntax " +"specification](https://spec.commonmark.org/). It adds features focussed " +"on scientific and technical documentation authoring, as detailed below." +msgstr "" + +#: ../../../docs/syntax/typography.md:8 +msgid "Headings" +msgstr "" + +#: ../../../docs/syntax/typography.md:10 +msgid "Markdown syntax denotes headers starting with between 1 to 6 #." +msgstr "" + +#: ../../../docs/syntax/typography.md:23 +msgid "Heading Level 3" +msgstr "" + +#: ../../../docs/syntax/typography.md:16 +msgid "" +"Note, that headings that are not at the root level of the document will " +"not be included in the table of contents. Using the " +"[attrs_block](#syntax/attributes/block) extension, you can also add " +"classes to headings" +msgstr "" + +#: ../../../docs/syntax/typography.md:34 +msgid "Paragraph heading" +msgstr "" + +#: ../../../docs/syntax/typography.md:27 +msgid "" +"To structure single and multiple documents into table of contents, see " +"the [organising content section](#organising-content)." +msgstr "" + +#: ../../../docs/syntax/typography.md:29 +msgid "" +"To reference a heading in your text, see the [cross-referencing " +"section](#syntax/referencing)." +msgstr "" + +#: ../../../docs/syntax/typography.md:34 +msgid "Paragraphs are block of text separated by a blank line." +msgstr "" + +#: ../../../docs/syntax/typography.md:36 +msgid "" +"Using the [attrs_block](#syntax/attributes/block) extension, you can also" +" add classes to paragraphs:" +msgstr "" + +#: ../../../docs/syntax/typography.md:52 +msgid "Here is a paragraph with a class to control its formatting." +msgstr "" + +#: ../../../docs/syntax/typography.md:46 +msgid "Thematic breaks" +msgstr "" + +#: ../../../docs/syntax/typography.md:48 +msgid "" +"You can create a thematic break, to break content between themes, using " +"three or more `*`, `-`, or `_` characters on a line by themselves." +msgstr "" + +#: ../../../docs/syntax/typography.md:55 +msgid "Inline Text Formatting" +msgstr "" + +#: ../../../docs/syntax/typography.md:57 +msgid "" +"Standard inline formatting including bold, italic, code, as well as " +"escaped symbols and line breaks:" +msgstr "" + +#: ../../../docs/syntax/typography.md:70 +msgid "**strong**, _emphasis_, `literal text`, \\*escaped symbols\\*" +msgstr "" + +#: ../../../docs/syntax/typography.md:63 +msgid "" +"The [strikethrough](syntax/strikethrough) extension allows you to add " +"strike-through text:" +msgstr "" + +#: ../../../docs/syntax/typography.md:76 +msgid "~~strikethrough with *emphasis*~~" +msgstr "" + +#: ../../../docs/syntax/typography.md:69 +msgid "" +"The [smartquotes](syntax/smartquotes) and " +"[replacements](syntax/replacements) extensions can improve the typography" +" of common symbols:" +msgstr "" + +#: ../../../docs/syntax/typography.md:85 +msgid "Smart-quotes 'single quotes' and \"double quotes\"." +msgstr "" + +#: ../../../docs/syntax/typography.md:87 +msgid "+-, --, ---, ... and other replacements." +msgstr "" + +#: ../../../docs/syntax/typography.md:78 +msgid "" +"Using the [attrs_inline](syntax/attributes/inline) extension, you can " +"also add classes to inline text spans:" +msgstr "" + +#: ../../../docs/syntax/typography.md:92 +msgid "A paragraph with a span of [text with attributes]{.bg-warning}" +msgstr "" + +#: ../../../docs/syntax/typography.md:85 +msgid "Line Breaks" +msgstr "" + +#: ../../../docs/syntax/typography.md:87 +msgid "" +"To put a line break, without a paragraph, use a `\\` followed by a new " +"line. This corresponds to a `
` in HTML and `\\\\` in LaTeX." +msgstr "" + +#: ../../../docs/syntax/typography.md:102 +msgid "**Fleas** \\ Adam \\ Had 'em." +msgstr "" + +#: ../../../docs/syntax/typography.md:98 +msgid "" +"Alternatively, you can use the `line-block` directive, which constructs a" +" block where all line breaks (and also initial indentations) are " +"respected:" +msgstr "" + +#: ../../../docs/syntax/typography.md +msgid "**Fleas**" +msgstr "" + +#: ../../../docs/syntax/typography.md +msgid "Adam" +msgstr "" + +#: ../../../docs/syntax/typography.md +msgid "Had 'em." +msgstr "" + +#: ../../../docs/syntax/typography.md:108 +msgid "Bullet points and numbered lists" +msgstr "" + +#: ../../../docs/syntax/typography.md:110 +msgid "" +"You can use bullet points and numbered lists as you would in standard " +"Markdown. Starting a line with either a `-` or `*` for a bullet point, " +"and `1.` for numbered lists. These lists can be nested using two spaces " +"at the start of the line." +msgstr "" + +#: ../../../docs/syntax/typography.md:130 +msgid "Lists can start with `-` or `*`" +msgstr "" + +#: ../../../docs/syntax/typography.md:131 +msgid "My other, nested" +msgstr "" + +#: ../../../docs/syntax/typography.md:132 +msgid "bullet point list!" +msgstr "" + +#: ../../../docs/syntax/typography.md:134 +msgid "My numbered list" +msgstr "" + +#: ../../../docs/syntax/typography.md:135 +msgid "has two points" +msgstr "" + +#: ../../../docs/syntax/typography.md:123 +msgid "" +"For numbered lists, you can start following lines with any number, " +"meaning they don't have to be in numerical order, and this will not " +"change the rendered output. The exception is the first number, which if " +"it is not `1.` this will change the start number of the list." +msgstr "" + +#: ../../../docs/syntax/typography.md:126 +msgid "Alternate numbering styles" +msgstr "" + +#: ../../../docs/syntax/typography.md:130 +msgid "" +"Using the [attrs_block](#syntax/attributes/block) extension, you can also" +" specify a alternative numbering styles:" +msgstr "" + +#: ../../../docs/syntax/typography.md:152 +msgid "" +"Using the [tasklist](syntax/tasklists) extension, you can also create " +"task lists:" +msgstr "" + +#: ../../../docs/syntax/typography.md:160 +msgid "Subscript & Superscript" +msgstr "" + +#: ../../../docs/syntax/typography.md:162 +msgid "" +"For inline typography for subscript and superscript formatting, the `sub`" +" and `sup` {{role}}, can be used respectively." +msgstr "" + +#: ../../../docs/syntax/typography.md:176 +msgid "H{sub}`2`O, and 4{sup}`th` of July" +msgstr "" + +#: ../../../docs/syntax/typography.md:170 +msgid "Quotations" +msgstr "" + +#: ../../../docs/syntax/typography.md:172 +msgid "" +"Quotations are controlled with standard Markdown syntax, by inserting a " +"caret (>) symbol in front of one or more lines of text." +msgstr "" + +#: ../../../docs/syntax/typography.md:185 +#: ../../../docs/syntax/typography.md:194 +msgid "We know what we are, but know not what we may be." +msgstr "" + +#: ../../../docs/syntax/typography.md:178 +msgid "" +"Using the [attrs_block](#syntax/attributes/block) extension, you can also" +" add an `attribution` attribute to a block quote:" +msgstr "" + +#: ../../../docs/syntax/typography.md:194 +msgid "Hamlet act 4, Scene 5" +msgstr "" + +#: ../../../docs/syntax/typography.md:187 +msgid "Definition lists and glossaries" +msgstr "" + +#: ../../../docs/syntax/typography.md:189 +msgid "" +"Using the [definition lists](syntax/definition-lists) extension, you can " +"define terms in your documentation, using the syntax:" +msgstr "" + +#: ../../../docs/syntax/typography.md:216 +msgid "Longer definition" +msgstr "" + +#: ../../../docs/syntax/typography.md:218 +msgid "With multiple paragraphs" +msgstr "" + +#: ../../../docs/syntax/typography.md:220 +#: ../../../docs/syntax/typography.md:243 +msgid "And bullet points" +msgstr "" + +#: ../../../docs/syntax/typography.md:205 +msgid "" +"Using the [attrs_block](#syntax/attributes/block) extension, you can also" +" add a `glossary` class to a definition list, that will allow you to " +"reference terms in your text using the [`term` role](syntax/roles):" +msgstr "" + +#: ../../../docs/syntax/typography.md:224 +msgid "my term" +msgstr "" + +#: ../../../docs/syntax/typography.md:227 +msgid "{term}`my term`" +msgstr "" + +#: ../../../docs/syntax/typography.md:216 +msgid "Field lists" +msgstr "" + +#: ../../../docs/syntax/typography.md:218 +msgid "" +"Using the [field lists](syntax/fieldlists) extension, you can create " +"field lists, which are useful in source code documentation (see [Sphinx " +"docstrings](inv:sphinx#info-field-lists)):" +msgstr "" + +#: ../../../docs/syntax/typography.md:239 +msgid "param arg1" +msgstr "" + +#: ../../../docs/syntax/typography.md:239 +msgid "A description of arg1" +msgstr "" + +#: ../../../docs/syntax/typography.md:240 +msgid "param arg2" +msgstr "" + +#: ../../../docs/syntax/typography.md:240 +msgid "A longer description, with multiple lines." +msgstr "" + +#: ../../../docs/syntax/typography.md:244 +msgid "return" +msgstr "" + +#: ../../../docs/syntax/typography.md:244 +msgid "A description of the return value" +msgstr "" + +#: ../../../docs/syntax/typography.md:234 +msgid "Comments" +msgstr "" + +#: ../../../docs/syntax/typography.md:236 +msgid "" +"You may add comments by putting the `%` character at the beginning of a " +"line. This will prevent the line from being parsed into the output " +"document." +msgstr "" + +#: ../../../docs/syntax/typography.md:239 +msgid "For example, this won't be parsed into the document:" +msgstr "" + +#: ../../../docs/syntax/typography.md:245 +msgid "Comments split paragraphs" +msgstr "" + +#: ../../../docs/syntax/typography.md:249 +msgid "" +"Since comments are a block-level entity, they will terminate the previous" +" block. In practical terms, this means that the following lines will be " +"broken up into two paragraphs, resulting in a new line between them:" +msgstr "" + +#: ../../../docs/syntax/typography.md:266 +msgid "a line" +msgstr "" + +#: ../../../docs/syntax/typography.md:268 +msgid "another line" +msgstr "" + +#: ../../../docs/syntax/typography.md:261 +msgid "Footnotes" +msgstr "" + +#: ../../../docs/syntax/typography.md:263 +msgid "" +"Footnotes use the [pandoc " +"specification](https://pandoc.org/MANUAL.html#footnotes). Their labels " +"**start with `^`** and can then be any alphanumeric string (no spaces), " +"which is case-insensitive." +msgstr "" + +#: ../../../docs/syntax/typography.md:266 +msgid "" +"If the label is an integer, then it will always use that integer for the " +"rendered label (i.e. they are manually numbered)." +msgstr "" + +#: ../../../docs/syntax/typography.md:267 +msgid "" +"For any other labels, they will be auto-numbered in the order which they " +"are referenced, skipping any manually numbered labels." +msgstr "" + +#: ../../../docs/syntax/typography.md:269 +msgid "" +"All footnote definitions are collected, and displayed at the bottom of " +"the page (in the order they are referenced). Note that un-referenced " +"footnote definitions will not be displayed." +msgstr "" + +#: ../../../docs/syntax/typography.md:287 +msgid "This is a manually-numbered footnote reference.[^3]" +msgstr "" + +#: ../../../docs/syntax/typography.md:288 +msgid "This is an auto-numbered footnote reference.[^myref]" +msgstr "" + +#: ../../../docs/syntax/typography.md:280 +msgid "" +"Any preceding text after a footnote definitions, which is indented by " +"four or more spaces, will also be included in the footnote definition, " +"and the text is rendered as MyST Markdown, e.g." +msgstr "" + +#: ../../../docs/syntax/typography.md:305 +msgid "A longer footnote definition.[^mylongdef]" +msgstr "" + +#: ../../../docs/syntax/typography.md:316 +msgid "This is not part of the footnote." +msgstr "" + +#: ../../../docs/syntax/typography.md:298 +msgid "" +"By default, the footnotes will be collected, sorted and moved to the end " +"of the document, with a transition line placed before any footnotes (that" +" has a `footnotes` class)." +msgstr "" + +#: ../../../docs/syntax/typography.md:301 +msgid "" +"This behaviour can be modified using the [configuration options](#sphinx" +"/config-options):" +msgstr "" + +#: ../../../docs/syntax/typography.md:309 +msgid "``myst_footnote_sort`` configuration option" +msgstr "" + +#: ../../../docs/syntax/typography.md:290 +msgid "This is an auto-numbered footnote definition." +msgstr "" + +#: ../../../docs/syntax/typography.md:307 +msgid "This is the _**footnote definition**_." +msgstr "" + +#: ../../../docs/syntax/typography.md:309 +msgid "That continues for all indented lines" +msgstr "" + +#: ../../../docs/syntax/typography.md:311 +msgid "even other block elements" +msgstr "" + +#: ../../../docs/syntax/typography.md:313 +msgid "" +"Plus any preceding unindented lines, that are not separated by a blank " +"line" +msgstr "" + +#: ../../../docs/syntax/typography.md:291 +msgid "This is a manually-numbered footnote definition." +msgstr "" + diff --git a/tasks.py b/tasks.py new file mode 100644 index 00000000..4eb47a4d --- /dev/null +++ b/tasks.py @@ -0,0 +1,11 @@ +import inspect +from pathlib import Path +import sys +ROOT = Path(__file__).resolve().parents[0] +sys.path.extend([str(ROOT/'src')]) +if not hasattr(inspect, 'getargspec'): # 修复 + inspect.getargspec = inspect.getfullargspec + +from tao.tools.write import site + +namespace = site('docs', target='docs/build/html')